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AN ARCHITECTURE FOR COMMUNICATING WITH ONE OR MORE 
ELECTRONIC DEVICES THROUGH A GATEWAY COMPUTER 

Copyright Disclaimer 

5 A portion of the disclosure of this patent document contains material that is subject to 

copyright protection. The copyright owner has no objection to the facsimile reproduction of 
the patent, as it appears in the Patent and Trademark Office patent files or records, but 
otherwise reserves all copyright rights whatsoever. 

10 Technical Field 

This invention relates generally to computer technology, and is more particularly 
directed toward systems and methods for communicating with embedded devices through a 
gateway. 

15 Background 

In recent years there has been a great increase in the amount of computer technology that 
is involved in daily life. In today's world, computer technology is involved in many aspects of a 
person's day. Many devices being used today by consumers have a small computer inside of the 
device. These small computers come in varying sizes and degrees of sophistication. These 

20 small computers include everything from one microcontroller to a fully-functional complete 
computer system. For example, these small computers may be a one-chip computer, such as a 
microcontroller, a one-board type of computer, such as a controller, a typical desktop computer, 
such as an IBM-PC compatible, etc. 

The small computers, (which can be rather large computers depending on the particular 

25 need which is being met by the computer), almost always have one or more processors at the 
heart of the computer. The processor(s) usually are interconnected to different external inputs 
and outputs and function to manage the particular device. For example, a processor in a 
vending machine for soda pop may be connected to the buttons used to select the pop, to the 
switch that allows a pop to drop down to a user, and to lights to indicate that the machine does 

30 not have any more pop of a particular variety. 

Computer technology is involved in many aspects of daily life. Many appliances, 
devices, etc., include one or more small computers. For example, refrigerators, telephones, 
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typewriters, automobiles, vending machines, and many different types of industrial equipment 
usually have small computers, or processors, inside of them. Computer software runs the 
processors of these computers and tells the processors what to do to carry out certain tasks. For 
example, the computer software running on a processor in a vending machine may cause a soda 
5 pop to drop to a user when the correct change has been entered by a user. 

These types of small computers that are a part of a device, appliance, tool, etc., are often 
referred to as embedded systems. The term "embedded system" usually refers to computer 
hardware and software that is part of a larger system. Embedded systems usually do not have 
typical input and output devices such as a keyboard, mouse, and/or monitor. Usually, at the 
10 heart of each embedded system is one or more processor(s). 

Summary and Objects of the Invention 

It is an object of the present invention to provide systems and methods for 
communicating with embedded devices through a gateway. 

15 An architecture is disclosed for facilitating communications with one or more 

embedded devices from a client application. The architecture includes gateway software and 
server software. The gateway software includes device communications software for sending 
and receiving device messages to and from the one or more embedded devices and gateway 
communications software for sending and receiving communications to other software. The 

20 server software includes user interface software that is downloadable by the client application 
for use to communicate with the server software. The server software also includes serving 
software for responding to requests received from the client application through the user 
interface software. The server software also includes gateway communications software for 
sending and receiving communications to the gateway software. The architecture operates 

25 such that the server software communicates with the gateway software and the gateway 
software communicates with the one or more embedded devices. The server software sends a 
user interface component to the client application, and the client application uses the user 
interface component to communicate with an embedded device by sending communications 
to the server software. The server software facilitates communications with the embedded 

30 device through the gateway software. 

In embodiments herein, the server software may include a web server. The user 
interface may comprise instructions written in HTML, HDML, WML, and the like. In 
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addition, the user interface software may include a Java applet. The serving software may 
include a Java servlet. 

The architecture may utilize a gateway computer in electronic communication with the 
one or more embedded devices. In addition, there may be a server computer in electronic 
5 communication with the gateway computer and also in electronic communication with a 
computer network for communications with a client device. 

In certain embodiments, the gateway software and the server software may be running 
on the same computer. As a result, a gateway server computer may be used to communicate 
with the one or more embedded devices. 



Brief Description of the Drawings 

The foregoing and other objects and features of the present embodiments will become 
more fully apparent from the following description and appended claims, taken in conjunction 
with the accompanying drawings. Understanding that these drawings depict only typical 
15 embodiments and are, therefore, not to be considered limiting of the invention's scope, the 
embodiments will be described with additional specificity and detail through use of the 
accompanying drawings in which: 
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1 is a block diagram of hardware components included in an embodiment; 

2 is a block diagram of hardware components included in an embodiment; 

3 is a block diagram of hardware components included in an embodiment; 

4 is a block diagram of hardware components included in an embodiment; 

5 is a block diagram of hardware components included in an embodiment; 

6 is a block diagram of hardware components included in an embodiment; 

7 is a block diagram of hardware components included in an embodiment; 

8 is a block diagram of software components included in an embodiment; 

9 is a block diagram of software components included in an embodiment; 

10 is a block diagram of software components included in an embodiment; 

1 1 is a block diagram of software components included in an embodiment; 

12 is a block diagram of software components included in an embodiment; 

13 is a block diagram of software components included in an embodiment; 

14 is a flow diagram of a method used with an embodiment; 



15 is a flow diagram of a method used with an embodiment; and 
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Figure 16 is a flow diagram of a method used with an embodiment. 
Detailed Description 

It will be readily understood that the components of the present invention, as generally 
5 described and illustrated in the Figures herein, could be arranged and designed in a wide variety 
of different configurations. Thus, the following more detailed description of the embodiments 
of the system and method of the present invention, as represented in the Figures, is not intended 
to limit the scope of the invention, as claimed, but is merely representative of the presently 
preferred embodiments of the invention. 

10 The presently preferred embodiments of the invention will be best understood by 

reference to the drawings, wherein like parts are designated by like numerals throughout. 

An architecture is disclosed for facilitating communications with one or more 
embedded devices from a client application. The architecture includes gateway software and 
server software. The gateway software includes device communications software for sending 

15 and receiving device messages to and from the one or more embedded devices and gateway 
communications software for sending and receiving communications to other software. The 
server software includes user interface software that is downloadable by the client application 
for use to communicate with the server software. The server software also includes serving 
software for responding to requests received from the client application through the user 

20 interface software. The server software also includes gateway communications software for 
sending and receiving communications to the gateway software. The architecture operates 
such that the server software communicates with the gateway software and the gateway 
software communicates with the one or more embedded devices. The server software sends a 
user interface component to the client application, and the client application uses the user 

25 interface component to communicate with an embedded device by sending communications 
to the server software. The server software facilitates communications with the embedded 
device through the gateway software. 

In embodiments herein, the server software may include a web server. The user 
interface may comprise instructions written in HTML, HDML, WML, and the like. In 

30 addition, the user interface software may include a Java applet. The serving software may 
include a Java servlet. 
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The architecture may utilize a gateway computer in electronic communication with the 
one or more embedded devices. In addition, there may be a server computer in electronic 
communication with the gateway computer and also in electronic communication with a 
computer network for communications with a client device. 
5 In certain embodiments, the gateway software and the server software may be running 

on the same computer. As a result, a gateway server computer may be used to communicate 
with the one or more embedded devices. 

Figure 1 is a block diagram of hardware components included in an embodiment. An 
embodiment of an architecture for facilitating communications with one or more embedded 

10 devices includes a client computer or device 20, a server computer 22 and a gateway 
computer 24. The gateway computer is in electronic communication with one or more 
embedded devices 26. 

The embedded device 26 is any device, appliance, machine, tool, or the like that is 
capable of receiving and/or sending electronic signals or messages or that may be enabled to 

15 receive and/or send electronic signals. Examples of devices 26 within the scope of the term 
device includes a vending machine, a telephone, a door lock, a temperature sensor, a motor, a 
switch, a light, a printer, a fax machine, a refrigerator, a health monitor, an elevator/escalator, 
a copier, a scanner, manufacturing equipment, industrial equipment, computer equipment and 
peripherals, security systems, monitoring equipment, and the like. The device 26 typically 

20 includes a processor (often, but not always, a microcontroller), memory, and a 
communications port as well as other input/output components. 

The various components used with embodiments herein may be in electronic 
communication with one another through various types of communication techniques. For 
example, embodiments herein may be used with many kinds of computer networks. 

25 In embodiments herein, the gateway computer 24 may be connected to the embedded 

devices 26 through a variety of connections, including RS 232, RS 485, modem, powerline, 
wired connection, wireless connection, etc. The embedded device 26 may be connected to 
various input and output devices (not shown) through a variety of ways. 

The client computer/device 20, the server computer 22 and the gateway computer 24 

30 are all broadly defined digital computers. A computer, as used herein, is any device that 
includes a digital processor capable of receiving and processing data. A computer includes 
the broad range of digital computers including microcontrollers, hand-held computers, 
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personal computers, servers, mainframes, supercomputers, and any variation or related device 
thereof. 

The client computer/device 20, the server computer 22 and the gateway computer 24 
may be separate computers. In addition, and as will be illustrated, they 20, 22, 24 may be the 
5 same computer. It will be appreciated that the functionality of these computers 20, 22, 24 
may be distributed across a number of computers, or it may be consolidated down into one or 
two computers. Thus, the required functionality is needed for embodiments herein, and those 
skilled in the art will appreciate that many different hardware/software configurations may be 
used to achieve embodiments herein. 
10 In current design, the server computer 22 and/or the gateway computer 24 are typically 

IBM-compatible personal computers running the Linux, Microsoft Windows NT, ME or 
2000/98/95 operating system. Of course, it will be appreciated by those skilled in the art that 
other types of hardware and/or software may be used to implement the embodiments 
disclosed herein. 

15 As shown, the client computer/device 20 may also be included with the embodiment. 

The client computer/device 20 may be a computer similar to that which may be used as a 
server computer 22. In addition, other computing devices may be used as the client 
computer/device 20, for example, besides typical personal computers, a cellular telephone, a 
personal digital assistant, a pager, etc. may also be used as the client computer/device 20. 

20 The embodiments herein may allow a user at a client computer/device 20 to access 

data/services at the embedded device 26 through the server 22 and/or gateway computer 24, 
even over great distances. The server computer 22, the gateway computer 24 and the client 
computer/device 20 may be connected together through various computer networks, such as a 
LAN, a WAN, the Internet, an intranet, direct-cable connections, dial-up connections, etc., or 

25 any combination thereof. 

Figure 2 is a block diagram of hardware components included in a further embodiment. 
As shown, an embodiment of an architecture for facilitating communications with one or 
more embedded devices may include a client computer or device 20, a server computer 22 
and a gateway computer 24. The gateway computer is in electronic communication with one 

30 or more embedded devices 26. As shown in Figure 2, the server computer 22 and the 
gateway computer 24 may be the same computer. Thus, the functionality of each system may 
be present on one computer system. In this embodiment, the client computer/device 20 is in 
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electronic communication with a server/gateway computer 23. The server/gateway computer 
23 is in electronic communication with one or more embedded devices 26. 

Figure 3 is a block diagram of hardware components included in a further embodiment. 
As shown, an embodiment of an architecture for facilitating communications with one or 
5 more embedded devices 26 may include a client computer or device 20, a server computer 22 
and a gateway computer 24 all being implemented on one computer 21. The 
client/server/gateway computer 21 is in electronic communication with one or more 
embedded devices 26. As shown, the functionality of each system may be present on one 
computer system 21. In this embodiment, the client computer/device functionality, the server 

10 computer functionality and the gateway computer functionality all communicate with each 
other on the same computer 21. The client/server/gateway computer 21 is in electronic 
communication with one or more embedded devices 26. 

As explained herein, the various components of the hardware embodiments shown in 
Figures 1-3 may be implemented in various ways with many different kinds of hardware and/or 

15 software combinations. Figures 4-7 illustrate further embodiments of hardware configurations 
that may be used with the inventive principles and concepts disclosed herein. Of course, it will 
be appreciated by those skilled in the art that additional changes may be made to embodiments 
herein without departing from the scope of the claims. 

Figure 4 is a block diagram of hardware components included in a further embodiment. 

20 As shown, the client computer 20 is a personal computer 30. The server computer 22 is also a 
type of personal computer 34. In the embodiment of Figure 4, the personal computer 30 
connects to the server PC 34 through a computer network 32. The computer network 32 
illustrated in Figure 4 is the Internet. The gateway computer 24 is also a type of personal 
computer 36. The gateway PC 36 and the server PC 34 are in electronic communication with 

25 one another. 

The gateway PC 36 is in electronic communication with one or more embedded 
devices 26. Examples of embedded devices 26 are shown in Figure 4. A propeller fan 26a 
may be in electronic communication with the gateway PC 36. Figure 4 also illustrates a flow 
control valve 26b as an embedded device. A microwave 26c may also be connected to the 
30 gateway PC 36. Some devices may be more directly connected to the gateway PC 36, while 
others may be more indirectly connected to the gateway PC 36. For example, as shown in 



-8- 



Figure 4, a fluorescent lamp 26d may be connected to the gateway PC 36 through a computer 
network 33. The computer network 33 may be the Internet, an intranet, a LAN, a WAN, etc. 

Figure 5 is a block diagram of hardware components included in a further embodiment. 
As shown, the client computer 20 is a cellular telephone 40. Figure 5 illustrates an 
5 embodiment where in the server computer 22 and the gateway computer 24 are the same 
computer 23. The server/gateway computer 23 is also a type of personal computer 42. In the 
embodiment of Figure 5, the client device cellular telephone 40 connects to the 
server/gateway PC 42 through a computer network 32. Many cellular telephones 40 and 
services are now commercially available for allowing a user to connect to the Internet and 

10 browse the World Wide Web through a mobile telephone. Such telephones 40 and services 
may be used with embodiments herein. 

The server/gateway PC 42 is in electronic communication with one or more embedded 
devices 26. Further examples of embedded devices 26 are shown in Figure 5. A vending 
machine 26e may be in electronic communication with the server/gateway PC 42. Figure 5 

15 also illustrates a router 26f as an embedded device. An outdoor metering device 26g may 
also be connected to the server/gateway PC 42. 

Figure 6 is a block diagram of hardware components included in a further embodiment. 
As shown, the client computer 20 is a personal digital assistant ("PDA") 44. The PDA is in 
electronic communication with the server PC 48 through a computer network 46. Figure 6 

20 illustrates an embodiment where the server computer 22 and the gateway computer 24 are in 
electronic communication with each other through a computer network 50. In the 
embodiment of Figure 6, the client PDA 44 communicates with the server PC 48 through a 
computer network 32. Many PDAs 44 and services are now commercially available for 
allowing a user to connect to the Internet or to another type of computer network. Such PDAs 

25 44 and services may be used with embodiments herein. 

As shown, the gateway PC 52 is a laptop computer 52. The gateway PC 52 is in 
electronic communication with one or more embedded devices 26. Further examples of 
embedded devices 26 are shown in Figure 6. A coffee maker 26h may be in electronic 
communication with the gateway PC 52. Figure 6 also illustrates a handheld device 26i as an 

30 embedded device. A stove 26j may also be connected to the gateway PC 52. 

Figure 7 is a block diagram of hardware components included in a further embodiment. 
In the embodiment of Figure 7, the functionality of the client computer 20, server computer 22 
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and gateway computer 24 is all on one computer 56. Figure 7 illustrates a dumb terminal 54 in 
electronic communication with the client/server/gateway PC 56. 

The client/server/gateway PC 52 is in electronic communication with one or more 
embedded devices 26. The embedded devices 26 illustrated in Figure 7 are a vending 
5 machine 26e, a stove 26j, a fluorescent lamp 26d and a microwave 26c. 

Figure 8 is a block diagram of software components included in an embodiment. 
Figures 1-7 illustrated possible hardware configurations that may be used with embodiments 
herein. Figures 8-13 illustrate possible software configurations that may be used with 
embodiments herein. It will be appreciated by those skilled in the art that the functionality 

1 0 discussed herein may be distributed across multiple computer systems, or it may be consolidated 
down into only one computer system. Thus, the examples of the software configurations are 
only meant as exemplary configurations and are not the only configurations that may be used. 

The embodiment of Figure 8 illustrates several pieces of device software 58. Each piece 
of device software is typically loaded and running on a device. Usually the device software 58 

15 is embedded in the particular device. Those skilled in the art appreciate will appreciate how to 
write software for embedded devices and how to load the software on the embedded device. 

The gateway software 60 provides communication to and from the devices to other 
computers and/or software that need to communicate with the embedded devices. The gateway 
software 60 is programmed to communicate with at least one type of embedded device. In the 

20 embodiments shown herein, the gateway 60 is programmed to communicate with several 
different types of embedded devices. Depending upon the type of device that the gateway needs 
to communicate with, different functionality may be programmed in the gateway. For example, 
if one device only understands on protocol, the gateway may be programmed to also understand 
that protocol so that it may communicate with the device. Alternatively, the device may be 

25 programmed with an additional protocol that the gateway 60 understands. 

The gateway software 60 is also programmed to access data and services at the devices. 
Typically, data, functions, events, etc., on the device that someone may want to access are made 
available by programming the gateway 60 and/or the device software 58 to expose these items. 
Those skilled in the art will appreciate that the device may be programmed to allow access to 

30 items on the device, or the gateway 60 may be programmed to access the items on the device, or 
a combination of programming in the device software 58 as well as the gateway software 60 
may be accomplished to facilitate access to items on the device. 
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The gateway software 60 also has the functionality to allow other computers to send and 
receive data or messages to the devices through use of the gateway software 60. Accordingly, 
the gateway 60 includes the functionality that would allow another computer to send messages 
to the gateway 60. For example, the gateway 60 may understand and be able to communicate 
5 using TCP/BP. In addition, the gateway 60 may include an application programming interface 
("API") that other computers may use in communicating with the gateway 60. The gateway 60 
would receive the message and perform any processing necessary. In some circumstances, the 
gateway 60 may forward the message on, whether in the same form or in an alternate form, to 
the particular device or devices. The gateway 60 may have the necessary information and/or 

10 functionality to process the message and respond to the message without needing to access or 
communicate with a device. 

There are commercially available software packages and technology that would serve as 
the gateway software 60 and that also could serve as the device software 58. em Ware, Inc. 
provides software solutions that can be used as gateway software 60 and that can be used as the 

15 device software 58 or to implement the device software 58, More particularly, EMIT® 
(Embedded Micro Internetworking Technology) software from em Ware may be licensed and 
used to implement gateway software 60 and/or device software 58. 

The server software 62 provides an interface to the gateway software 60 for the client 
software 64. The server software 62 is programmed to service requests from the client software 

20 64. In servicing the requests, the server software 62 may communicate with the gateway 
software 60. If the server software 62 has sufficient information and functionality to service the 
request alone or with the assistance of third-party software, it may service the request without 
communicating with the gateway software 60. Because the server software 62 serves as an 
interface between client software 64 and the gateway software 60, the server 62 is programmed 

25 to communicate with the client software 64 and is also programmed to communicate with the 
gateway software 60. Those skilled in the art will appreciate the many communication 
techniques that may be used to communicate with the client software 64 and/or the gateway 
software 60. 

The client software 64 serves as an interface for a user to communicate with the 
30 embedded devices. The particular features of the client software 64 may vary depending upon 
the device or devices that are being accessed with the software 64. The client software 64 
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communicates with the embedded devices through the server software 62 and the gateway 
software 60, as shown and described. 

Figure 9 is a block diagram of software components included in a further embodiment. 
The embodiment of Figure 9 illustrates the gateway software 60 and the device software 58 as 

5 shown and described above. In this embodiment, the client software 66 may be a more general 
program capable of processing data. For example, the client software 66 may be a web browser, 
a document editor, a media player, a program for receiving streams, etc. The thin client 68 is a 
software component that can be processed or used by the client software 66 in order to present 
information or an interface to a user. The server and gateway interface software 70 serves to 

10 receive and process requests from the client software 66 and/or the thin client 68. In the 
embodiment of Figure 9, the client software 66 includes functionality that enables the thin client 
68 to be smaller and more particularly focused on the data or information necessary for a user 
interface to communicate with the device. If a user already has the client software 66, then only 
the thin client 68 needs to be obtained for communications to and from the devices. 

15 Figure 10 is a block diagram of software components included in a further embodiment. 

The embodiment of Figure 10 is implemented using techniques and components commonly 
used with the World Wide Web (the "Web"). A web browser 72 is used by a user to 
communicate with the devices. Web browsers are commercially available and are commonly 
used by persons accessing the Internet. 

20 In this embodiment, a browser component 74 includes the user interface and 

functionality necessary to communicate with the embedded devices through a web server 76 and 
the gateway software 60. A browser component 74 is any set of instructions that can be 
processed by the browser 72 to provide a user interface to a user through which the user can 
communicate with the embedded devices. Examples of browser components 74 will be shown 

25 and discussed with Figure 1 1 . 

The web server and gateway interface 76 receive and process requests from the browser 
72 and/or browser component 74 and send appropriate communications to the gateway software 
60 as necessitated by the requests from the user. Web servers are commercially available and 
can be used in implementing the embodiment of Figure 10 as long as the necessary gateway 

30 communications functionality is added to the server. The gateway interface portion of the web 
server includes the functionality and logic to communicate with the gateway. 



-12- 



Figure 1 1 is a block diagram of software components included in a further embodiment. 
The embodiment of Figure 1 1 includes a web browser 78 communicating with a web server 80 
over the Internet 82. 

The browser 78 can use various components to provide a user interface to a user. For 
5 example flash 84, DHTML 86, Javascript 88, Shockwave 90 and/or an applet 92 may be used to 
provide an interface to a user for communicating with or accessing an embedded device. Of 
course, it will be appreciated by those skilled in the art that other 94 components may also be 
used. 

The web server 80 may use various components to process requests from the user. For 

10 example, the web server 80 may user one more of any of the following: servlets 96, CGI scripts 
98 or ActiveX components 100. Of course, it will be appreciated by those skilled in the art that 
other components 104 may also be used. 

The web server 80 may also include other gateway interface 102 instructions and/or 
components. Many components available may be programmed with the functionality necessary 

15 to communicate with the gateway 60. For example, servlets 96, CGI scripts 98 and ActiveX 
components may all be programmed and used to communicate with the gateway 60. In 
addition, gateway interface instructions 102 may be provided. 

Figure 12 is a block diagram of software components included in a further embodiment. 
The embodiment of Figure 12 illustrates handheld device software 106 communicating with the 

20 web server 80 over a communications network 108. The handheld device 106 may be any type 
of electronic device capable of processing instructions to provide an interface for a user. The 
interface could be a visual user interface, an audio interface, or any other type of interface that 
would allow a user or client to communicate with server type software to achieve 
communications with an embedded device. 

25 The handheld device software 106 can use various components to provide a user 

interface to a user. For example WML 1 10 or HDML 1 12 may be used to provide an interface 
to a user for communicating with or accessing an embedded device. Of course, it will be 
appreciated by those skilled in the art that other 1 14 components may also be used. Each type 
of handheld device may have particular software techniques, components, modules, etc., that 

3 0 may be particularly suited for use with the device. 

The communication network 108 may be any one or more networks capable of 
electronic communications. For example, the communications network 108 may include a 



-13- 



wireless network (not shown) as well as a global computer network, such as the Internet. In 
addition, the communications network 108 may include local area networks, wide area 
networks, cellular networks, pager networks, direct cable connections, dial-up connections, etc. 
Figure 13 is a block diagram of software components included in a further embodiment. 
5 Figure 13 illustrates a more generic application 116 communicating with a web server 80 over a 
communications network 118. The application 116 uses a client component 120 to provide a 
user interface to a user. The client 120 may be downloaded from the web server 80 for use by 
the application 116. 

As shown, the web server 80 may use third party software 122 in accomplishing its 

10 tasks. Third party software 122 may include a variety of programs or sets of instructions to 
accomplish tasks that are necessary or that are helpful to the web server 80 or any of its 
components. For example, the third party software 122 may include security components for 
restricting access or verifying a user's identity, providing weather information, storing or 
accessing user preferences, aggregating data, emailing messages to recipients, etc. 

15 The web server 80 may also access a database 124 to store or retrieve information that 

may be needed. For example, the web server 80 may be receiving communications from many 
embedded devices. In this situation, the web server 80 may store the information or data it 
receives in a database 124. The database 124 may also be used to store the various components 
that are sent to client computers 20. 

20 Figure 14 is a flow diagram of a method used with an embodiment. Generally, a client 

or device requests 126 data from the server. The server responds by sending 128 the data 
requested to the client. Using the data received, the client sends 130 a device request to the 
server. The device request is any communication that relates to an embedded device. 

The server receives 132 the request and, if necessary, communicates 134 the request to 

25 the gateway and/or third party software. The gateway accesses or communicates 136 with the 
device or devices to fulfill the request. The gateway then sends 138 a response to the server. 
The server may send 140 a response to the client and/or to third party software. The client 
receives 142 the response and may perform further processing. If the client desires to send more 
requests to the server, as shown, the client sends 130 another request to the server, and the 

30 processing may continue as shown and discussed. If the client has no more need to 
communicate with the server and embedded devices, the process may be complete. 
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Figure 15 is a flow diagram of a method used with a further embodiment. The 
embodiment of Figure 15 is more particularly directed towards an embodiment using a web 
browser and web server. The browser requests 144 the user interface from the server. This 
request may simply be an HTTP request for a particular document or component, it may be a 
5 command sent to a component on the server, etc. 

The server receives the request and sends 146 the user interface component to the 
browser. The browser then receives the component and opens, executes or otherwise uses 148 
the component to provide an interface for the user to communicate with one or more embedded 
devices via the server and gateway communication pathway. 
10 Using the user interface, the user sends 150 device requests. The device requests are 

serviced, as discussed herein. The request and the processing of the request may be repeated 
until all requests have been serviced. 

Figure 16 is a flow diagram of a method used with a further embodiment. The 
embodiment of Figure 16 illustrates the server/gateway side of processing. The server receives 
15 154 a device request from a client. The server may determine whether any third party software 
is needed to fulfill the request. If third party software is needed, the third party software may 
then be accessed or executed 156, as needed. The server may then send 158 a response back to 
the browser. If more processing is needed, the flow of steps may continue as illustrated. 

The server may determine whether the gateway is needed to fulfill the request. If the 
20 gateway is not needed, then the server may service 160 the request and send 158 a response 
back to the browser. If more processing is needed, the flow of steps may continue as illustrated. 

If the gateway is needed to fulfill the request, the server may send 162 a message to the 
gateway to facilitate the request being fulfilled. The gateway may fulfill 164 the request, either 
partially or fully, by processing the message and/or by providing requested information, or by 
25 providing the data necessary for the server to provide the proper response. The gateway may 
then send 166 a response back to the server. The server may send 158 a response to the 
browser. If more processing is needed, the flow of steps may continue as illustrated. 
WAP and EMIT SDK Example 

The following WAP ("Wireless Application Protocol") example provides a basic 
30 tutorial on using WML ("Wireless Markup Language") and HDML ("Handheld Device Markup 
Language") along with software and hardware packages available from em Ware, Inc., including 
EMIT®, em Ware's emGateway™ software and development kits. 
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WML and HDML are the basis for presentation on web-enabled wireless devices 
including cellular phones and PDA's. The examples herein can be used and viewed from a 
WAP enabled device or emulator. To implement and use these examples, a server needs to 
be configured for WML and HDML. A WAP emulator or simulator may also be useful. One 
5 such simulator is provided by Phone.Com: the UP. Simulator. This simulator is presently 
available from the Phone.com developer site. To run the servlets, a servlet engine is needed. 
One such servlet engine is the Resin Servlet Runner. 

A resource constraint of the wireless devices being sold today is the amount of 
onboard memory. Because of this current constraint, it is recommended that each individual 

10 Deck be limited to 1350 bytes of 'compiled' data. (A "Deck" is a commonly used description 
of an entire file sent to the wireless device. A Deck may contain many "cards".) Although 
some phones will support much larger file sizes, there are presently a large number of WAP 
devices that will support no more than the recommended size. "Compiled" in this context 
means it is compressed by the WAP gateway for sending to the mobile phone. Different 

15 WAP gateways vary in how they compile a WML page. Accordingly, if a particular page is 
close to the limit, it may be that occasionally it does not work on some gateways, or even 
some phones. Another current resource constraint of wireless devices is their slow 
connection. Most devices top out at about 9600 bps. As a result, the present embodiments 
keep the file size small. However, it will be appreciated by those skilled in the art that 

20 wireless devices will be equipped with more resources, with the ability to connect at higher 
data rates, etc., such that the current need to keep the file sizes small will no longer be an 
issue. 

An understanding of programming using HDML and WML is assumed. Many 
resources are currently available to educate and train programmers in HDML and WML. 

25 Accordingly, these examples will focus on how to use WML and HDML with em Ware® 
technology to achieve the present embodiments. The examples will not attempt to teach the 
basics of HDML or WML programming. The following examples use the EMIT®-enabled 
Hitachi H8 SDK board available from em Ware. The examples also use the emGateway™ 
software and a Java servlet. 

30 The following example is a simple application that connects to and controls an 

EMIT®-enabled Hitachi H8 SDK board using emGateway™ software and a Java servlet. 
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The SDK board currently includes LEDs and a rotary knob. These applications will pull the 

values of the red and green LEDs and the rotary knob, and display them on the wireless 

device. The applications also allow a user to change the values on the red and green LEDs 

(this will adjust their brightness). 

5 The following examples use a servlet and HDML: 

import java.io.*; 
import javax.servlet.*; 
import javax.servlet.http.*; 
import java.awt.*; 
10 import java.util.*; 

import java.awt.event.*; 
import emJava20.emCore.*; 
import com.emWare.emClient.*; 
import com.emWare.emAWT *; 

15 

public class emitsdkhdml extends HttpServlet 
{ 

JEmit jemit; 
public emitsdkhdml() 
20 { 

jemit = new JEmit(); 

try 

{ 

jemitsetHost("10.1.1.29 H ); 
25 jemit.setPort(88); 

/* 

jemit.setUsername("Username goes here if Nec."); 
jemit.setPassword("Password Goes here if Nec."); 
*/ 

30 jemit.setDevice( M d=005040000001"); 

jemit.connect(); 

} 

catch (Exception e) 
{ 

35 System.out.println("Connecting: "+ e); 

} 

try 
{ 

jemit.poll(); 

40 } 

catch (Exception e) 

{ 

System.out.printlnC'Starting poll: "+e); 
} 

45 } 
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public void doGet(HttpServletRequest req, HttpServletResponse res) throws ServletException, 
lOException 

{ 

res.setContentType("text/x-hdml"); 
5 PrintWriter out = res.getWriter(); 

try 
{ 

Short redObj = (Short)jemitgetVariable("Red B ); 

short redValdrt = redObj.shortValue(); 
10 int redVallnt = redValdrt; 

String redVal = Integer.toString(redVallnt); 

Short greenObj = (Short)jemit.getVariable("Green H ); 

short greenValdrt = greenObj.shortValue(); 

int greenVaNnt = greenValdrt; 
1 5 String greenVal = I nteg er. toStri ng(g ree n Va 1 1 nt) ; 

Short knobObj = (Short)jemit.getVariable( N Knob n ); 

short knobValdrt = knobObj.shortValue(); 

int knobVallnt = knobValdrt; 

String knobVal = I ntege r. toStri ng (knobVal 1 n t); 
20 Random rand = new Random(); 

if (req.getParameter( M laber)==null) 

{ 

out.println("<HDML VERSION=3.0 TTL=0>"); 

outprintlnf <!-- Sets variables then skips to #home -->"); 



25 


out.println(" 


<nodisplay>"); 




outprintlnf" 


<ACTION TYPE=ACCEPT TASK=GO DEST=#home 




VARS=red="+redVal+ ,, &green="+greenVal+ ,, &knob= ,, +knobVal+">"); 




out.println(" 


</nodisplay> "); 




outprintlnf 


<DISPLAY NAME=home>"); 


30 


outprintlnf 


<ACTION TYPE=ACCEPT TASK=GO 




DEST=http://"+req.getSeiverNam 




()+"#menuVARS=red= l, +redVal+"&green= ,, +greenVal+"&knob="+knobVal+"> ■); 




out.printin(" 


<CENTER>Helio!<br>"); 




out printing 


Welcome to<br>"); 


35 


outprintlnf 


EMWARE<br>"); 




outprintlnf 


 <br>"); 




out.println(" 


Press OK to go to the menu page."); 




out.println(" 


</DISPLAY>"); 




outprintlnf 


<CHOICE name=menu>"); 


40 


outprintlnf" 


<ACTION TYPE=SOFT1 LABEL=Refresh TASK=GO 




DEST=http://"+req.getServerName()+^^ 




()+"#menu VARS=red= ,, +redVai+ ,, &green= ,, +greenVal+"&knob= l, +knobVal+">"); 




out. printing 


Red: $red<br>"); 




outprintlnf 


Green: $green<br>"); 


45 


outprintlnf 


Knob: $knob<br>"); 




outprintlnf 


<CE TASK=GO DEST=#setred LABEL=Red>Set Red LED"); 




outprintlnf 


<CE TASK=GO DEST=#setgreen LABEL=Green>Set Green LED* 1 ); 
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outprintlnf <CE TASK=GO DEST=#home LABEL=Home>Go Home"); 

out.println( n </CHOICE>"); 

out.println(" <ENTRY NAME=setred KEY=red FORMAT=NNN>"); 

out.println(" <ACTION TYPE=accept LABEL=Set TASK=GO 

5 VARS=red="+redVal+" 

DEST=http://"+req.getSelverName()+^ , '+req.getServerPort()+"''+req.getRequestURI()+"?label=1&val=$ 
red>"); 

out.println(" Enter the new value of red:"); 

out.println(" </ENTRY>"); 
10 out.println(" <ENTRY NAME=setgreen KEY=green FORMAT=NNN>"); 

out.printlnf <ACTION TYPE=accept LABEL=Set TASK=GO 

VARS=green="+greenVal+" 

DEST=http://"+req.getServerName0+":"+req.getServerPort()+" l '+req.getRequestURI0+"?label=2&val=$ 
green>"); 

1 5 out.println(" Enter the new value of green:"); 

out.println(" </ENTRY>"); 
out.println("</HDML>"); 

} 

else if (lnteger.parselnt(req.getParameter("laber))==1) 
20 { 

int i = lnteger.parselnt(req.getParameter("val")); 
jemit.setVariable( "Red",new lnteger(i)); 

res.sendRedirect("http://"+req.getServerName()+":"+req.getServerPort()+""+req.getRe 
questURI()+"#menu"); 
25 } 

else if (lnteger.parselnt(req.getParameter("laber))==2) 

{ 

int i = lnteger.parselnt(req.getParameter("val")); 
]emit.setVariable( "Green",new lnteger(i)j; 
30 res.sendRedirect( M http:// n +req.getServerNameOV':' , +req.getSeiverPortO+' , "+req.getRe 
questURI()+"#menu"); 
} 
} 

catch (Exception e) 

35 { 

out.println(e); 

} 

} 

40 protected void finalize() 
{ 

System.out.println("finalize() Called"); 
try 

{ 

45 jemit.disconnect(); 

} 

catch(Exception e) 
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{ 

System.out.printlnfException disconnecting: "+e); 

} 

} 

5 } 

As illustrated, the above example connects to and controls the EMIT®-enabled 
Hitachi H8 SDK board using emGateway™ software and a Java servlet The above example 
pulls the values of the red and green LEDs and the rotary knob, and displays them on the 
wireless device. The following examples use a servlet and WML t 

10 import java.io.*; 

import javax.servlet*; 

import javax.servlet.http *; 

import java.awt*; 

import java.util.*; 
1 5 import java.awt.event.*; 

import emJava20.emCore *; 

import com.emWare.emClient *; 

import com.emWare.emAWT *; 

20 public class emitsdkwml extends HttpServlet 
{ 

JEmit jemit; 
public emitsdkwml() 

{ 

25 jemit = new JEmit(); 
try 

{ 

jemit.setHost("10.1.1.29 ,, ); 
jemit.setPort(88); 
30 /* 

jemit.setUsernamefUsername goes here if Nec."); 
jemit.setPasswordfPassword Goes here if Nec."); 
*/ 

jemit.setDevice("d=005040000001 H ); 
35 jemit.connect(); 

} 

catch (Exception e) 
{ 

System.out.println("Connecting: "+ e); 

40 } 
try 

{ 

jemit.poll(); 

} 

45 catch (Exception e) 
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{ 

System. out.println("Starting poll: "+e); 

} 
} 

5 

public void doGet(HttpServletRequest req, HttpServletResponse res) throws ServletException, 
lOException 

{ 

res.setContentType("text/vnd.wap.wml"); 
1 0 PrintWriter out = res.getWriter(); 
try 
{ 

Short redObj = (Short)jemit.getVariable("Red"); 
1 5 short red Valdrt = redObj.shortValue(); 
int redVallnt = redValdrt; 
String redVal = Integer.toString(redVallnt); 

Short greenObj = (Short)]emit.getVariable("Green"); 
20 short greenValdrt = greenObj.shortValue(); 
int green Vail nt = greenValdrt; 
String greenVal = Integer.toString(greenVallnt); 

Short knobObj = (Short)jemit.getVariable("Knob"); 
25 short knobValdrt = knobObj.shortValue(); 
int knobVallnt = knobValdrt; 
String knobVal = Integer.toString(knobVallnt); 

if (req.getParameter("page")==null) 
30 { 

writelndex(out); 

} 

else if (req.getParameter("page n ).equals("Menu n )) 
{ 

35 writeMenu(out, redVal, greenVal, knobVal); 
} 

else if (req.getParameter("page").equals("Polled")) 
{ 

writePolled(out, redVal, greenVal, knobVal); 

40 } 

else if (req.getParameter("page").equals("ChangeRed")) 
{ 

writeChangeRed(out, redVal); 

} 

45 else if (req.getParameter("page").equals("ChangeGreen")) 
{ 

writeChangeGreen(out, greenVal); 



-21- 



} 

else if (req.getParameter("page").equais("ChangeMode")) 
{ 

writeChangeMode(out); 

5 } 

else if (req.getParameter("page u ).equals("Both")) 
{ 

if (req.getParameter("Min n ) != null) 
{ 

10 int i = lnteger.parselnt(req.getParameter("Min")); 

jemit.setVariable( "Red",new Integer(i)); 
jemit.setVariable( "Green",new lnteger(i)); 
res.sendRedirect("?page=Menu"); 

} 

15 

else if (req.getParameter("Max") != null) 
{ 

int i = lnteger.parselnt(req.getParameter("Max")); 
jemit.setVariable( "Red",new Integer®); 
20 jemitsetVariable( "Green",new Integer(i)); 

res.sendRedirect("?page=Menu"); 

} 

} 

else if (req.getParameter("page").equals("SetRed")) 
25 { 

if 

(!(req.getParameter(^edVal").equals( m, ))&&((lnteger.parselnt(req.getPa 
er.parselnt(req.getParameter("redVar'))<=255))) 

{ 

30 int i = lnteger.parselnt(req.getParameter("redVal")); 

jemit.setVariable( "Red" I new Integer(i)); 
res.sendRedirect("?page=Menu"); 

} 

else 
35 { 

res.sendRedirect("?page=Error"); 

} 

} 

else if (req.getParameter("page").equals("SetGreen")) 
40 { 

if 

(!(req.getParameter("greenV^ 
lnteger.parselnt(req.getParameter("greenVal"))<=255))) 

{ 

45 int i = lnteger.parselnt(req.getParameter("greenVal")); 

jemit.setVariable( "Green",new integer(i)); 
res.sendRedirect("?page=Menu"); 
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} 

else 
{ 

res.sendRedirect("?page=Error"); 

5 } 

} 

else if (req.getParameter("page").equals("SetMode")) 
{ 

int i = lnteger.parselnt(req.getParameter("Mode")); 
1 0 jemit.setVariable( "ChgMode",new Integer(i)); 
res.sendRedirect("?page=Menu"); 

} 

else if (req.getParameter("page").equals("Error")) 

{ 

15 writeError(out); 
} 
} 

catch (Exception e) 
{ 

20 out.println(e); 
} 

} 

public void writelndex(PrintWriter out) 

{ 

25 // Begin wml page: "Index" 

out.println("<?xml version=\"1 .0V?>"); 

out.println("<!DOCTYPE wml PUBLIC Y*-//WAPFORUM//DTD WML 1 .1//ENV"); 
out.println(" \"http://www. wapforum.org/DTD/wml_1 . 1 .xml\">"); 

30 out.println("<wml>"); 

out.println("<!- ^#////////////////////////// Index II II II II II II II II II II II II II II II II II II II II II II -> "); 
out.println("<head> "); 

out.println("<meta http-equiv=\"Cache-Control\" content=\"max-age=0\'7> "); 
out.println("</head> "); 
35 out.println("<card>"); 

out.println(" <do type=\"accept\"> "); 

out.printlnj" <go method=\"post\" href=\"emitsdkwml?page=Menu\"/>"); 

out.println(" </do>"); 

out.println(" <p align=\"center\">"); 
40 outprintlnj" Welcome to <br/>"); 

out.println(" the EMWARE<br/>"); 

out.printlnj" SDK Demo<br/>"); 

out.printlnf Press OK to go to the menu page. "); 

out.println(" </p>"}; 
45 out.println("</card>"); 

out.println("</wml>"); 

mmmmmimm\m\mmi\i\MMmmmmiimmmnimmi\iii\i\i\\n 
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// End wml page; "Index" 

} 

public void writeMenu(PrintWriter out, String redVal, String greenVal, String knobVal) 
{ 

5 // Begin wml page: "Menu" 
/////////////////////////////////////M 

out.println("<?xml version=\"1 .0\"?>"); 

out.println("<!DOCTYPE wml PUBLIC \"-//WAPFORUM//DTD WML 1.1//EN\""); 
out.println(" \"http://www. wapforum.org/DTD/wml_1 . 1 .xml\">"); 

10 out.println("<wml> "); 
out.println("<head> "); 

out.println("<meta http-equiv=\"Cache-Control\" content=\"must-revalidate\"/> "); 

out.println("<metahttp-equiv=\"Cache-Control\"content=\"no-cache\"/>"); 

out.println("</head>"); 
15 outprintlnj""); 

o ut. printl n("<card>"); 

out.println(" <p>Red LED: "+redVal+""); 

outprintlnj" <br/>Green LED: "+greenVal+""); 

outprintlnj" <br/>Knob Value: "+knobVal+""); 
20 out.printlnf <br/>"); 

out.printlnf <anchortitle=\"Polled\"><go method=\"post\" href=\"emitsdkwml?page=Polled\">"); 

outprintlnf </go>Polled Values</anchor><br/>"); 

out.println(" <anchor title=\"Red\"xgo method=\"post\" 

href=\"emitsdkwml?page=ChangeRed\">"); 
25 out.println(" </go>Change Red LED</anchor><br/>"); 

out.println(" <anchor title=\"Green\"><go method=\"post\" 

href=\"emitsdkwml?page=ChangeGreen\">"); 

out.println(" </go>Change Green LED</anchor><br/>"); 

out.println(" <anchor title=\"Mode\"><go method=\"post\" 

30 href=\"emitsdkwml?page=ChangeMode\">"); 

out.println(" </go>Change Mode</anchor><br/>"); 

out.println(" <anchor title=\"Min\"xgo method=\"post\" 

href=\"emitsdkwml?page=Both&Min=0\">"); 

out.printlnf </go>Set Both to Min</anchor><br/>"); 
35 out.println(" <anchor title=\"Max\"><go method=\"post\" 

href=\"emitsdkwml?page=Both&Max=255\">"); 

out.println(" </go>Set Both to Max</anchor><br/>"); 
out.println(" </p>"); 
out.println("</card>"); 
40 out.println("</wml>"); 

II End wml page: "Menu" 

} 

public void writePolled(PrintWriter out, String redVal, String greenVal, String knobVal) 

45 { 

// Begin wml page: "Polled" 

lllllllllllllllllllllllllllllllllllim 
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out.println("<?xml version=\"1 .0\"?>"); 

out.println("<!DOCTYPE wml PUBLIC V-//WAPFORUM//DTD WML 1.1//ENV"); 
out.println(" \"http://www.wapforum.org/DTD/wml_1 .1 .xml\">"); 

out.println("<wml> "); 
5 out.println("<head> "); 

out.println("<meta http-equiv=\"Cache-Control\" content=\"must-revalidate\"/> "); 

out.println(' , <metahttp-equiv=\' l Cache-Control\"content=\"no-cache\7>''); 

out.println("</head>"); 

out.println(""); 

10 out.println("<card ontimer=\"emitsdkwml?page=Polled\">"); 

out.println("<timervalue=\"50\7>"); 

out.println(" <do type=\"accept\" label=\"Menu\"> "); 

out.println(" <go method=\"post\" href=\"emitsdkwml?page=Menu\"/>"); 

out.println(" </do>"); 
15 out.printlnf <p>Red LED: "+redVal+""); 

outprintlnj" <br/>Green LED: "+greenVal+""); 

out.println(" <br/>Knob Value: "+knobVal+""); 

out.println(" </p>"); 

out.println("</card>"); 
20 out.println("</wml>"); 

out.println(" "); 

/////////////////////////////////////////////////////// 
// End wml page: "Polled" 

} 

25 public void writeChangeRed(PrintWriter out, String redVal) 
{ 

// Begin wml page: "ChangeRed" 

out.println("<?xml version=\"1 .0\"?>"); 
30 out.println("<!DOCTYPE wml PUBLIC V-//WAPFORUM//DTD WML 1 .1//ENV'"); 
out.println(" \"http://www.wapfonjm.org/DTD/wml_1 .1 .xml\">"); 
out.println("<wml> "); 
out.println("<head> "); 

out.println("<meta http-equiv=\"Cache-Control\" content=\"must-revalidate\"/> "); 
35 out.println("<meta http-eq u i v=\" Cache-Contro !\" content=\"no-cache\7>"); 
out.println("</head>"); 
out.println(""); 
out.println("<card>"); 

out.println(" <do type=\"accept\" label=\"Enter\">"); 
40 out.println(" <go method=\"post\" href=\"emitsdkwml?page=SetRed&redVal=$red\">"); 
out.println(" </go>"); 
out.println(" </do>"); 

outprintlnf <p>Red LED: "+redVal+""); 
outprintlnf <br/>Enter new value<br/>"); 
45 outprintlnj" * Must be between 0 and 255"); 

out.println(" <input name=\"red\" format=\"*N\" maxlength=\"3\7>"); 
out.println(" </p>"); 
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out.println("</card>"); 
out.println("</wml>"); 
llllllllllllllllllllllllllllllllllim 
II End wml page: "ChangeRed" 

5 } 

public void writeChangeGreen(PrintWriterout, String greenVal) 
{ 

// Begin wml page: "ChangeGreen" 

10 out.println("<?xml version=\"1.0\"?>"); 

out.println("<!DOCTYPE wml PUBLIC V-//WAPFORUM//DTD WML 1.1//ENV'"); 
outprintlnf \"http://www.wapfonjm.org/DTD/wml_1 .1 .xml\">"); 
out.println("<wml> "); 
out.println("<head> "); 

1 5 out.println("<meta http-equiv=\"Cache-Control\" content=\"must-revalidate\"/> "); 

out.println("<meta http-equiv=\"Cache-Contral\"content=\"no-cache\7>"); 

out.println("</head>"); 

outprintln(""); 

out.println("<card>"); 
20 outprintlnf <do type=\"accept\" label=\"Enter\">") ; 

out.println(" <go method=\"post\" 
href=\"emitsdkwml?page=SetGreen&greenVal=$green\">"); 

out.println(" </go>"); 

out.println(" </do>"); 
25 out.println(" <p>Green LED: "+greenVal+""); 

out.println(" <br/>Enter new value<br/>"); 

out.println(" * Must be between 0 and 255"); 

out.println(" <input name=\"green\" format=\"*N\" maxlength=\"3\7>"); 

out.println(" </p>"); 
30 out.println("</card>"); 

out.println("</wml>"); 

\m\\\m\mm\m\m\m\m\mmmm\mimm\m\m\m\\mm\imiim\ 

II End wml page: "ChangeGreen" 

} 

35 public void writeChangeMode(PrintWriter out) 
{ 

// Begin wml page: "ChangeMode" 
////////////////////////////////////////////////////////W 
out.println("<?xml version=\"1 .0\"?>°); 
40 out.println("<!DOCTYPE wml PUBLIC V-//WAPFORU M//DTD WML 1.1//ENV'"); 
outprintinf \"http://www.wapforum.org/DTD/wml_1 .1 .xml\">"); 
out.println("<wml> "); 
out.println("<head> "); 

out.println("<meta http-equiv=\"Cache-Control\" content=\"must-revalidate\"/> "); 
45 out.println("<meta http-equiv=\"Cache-Control\" content=\"no-cache\"/>"); 
out.println("</head>"); 
out.printlnf"); 
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out.println("<card>"); 

outprintlnC <do type=\"option\" label=\"Menu\">"); 
out.println(" <go method=\"post\" href=\"emitsdkwml?page=Menu\">"); 
out.println(" </go>"); 
5 out.println(" </do>"); 
out.println(" <p>"); 

out.println(" <anchor title=\"Local\"><go method=\"post\" 

href=\"emitsdkwml?page=SetMode&Mode=0\">"); 
out.println(" </go>Local Control</anchor><br/>"); 
10 out.println(" <anchor title=\"Phone\"><go method=\"post\" 

href=\"emitsdkwml?page=SetMode&Mode=3\">"); 
out.println(" </go>Phone Control</anchor><br/>"); 
out.println(" </p>"); 
out.println("</card>"); 
15 out.println("</wml>"); 

II End wml page: "Changemode" 

20 } 

public void writeError(PrintWriter out) 

{ 

// Begin wml page: "Error" 
//////////////////////////////////////M 
25 out.println("<?xml version=\"1 .0\"?>"); 

out.println("<!DOCTYPE wml PUBLIC V-//WAPFORU M//DTD WML 1.1//EN\""); 
out.println(" \"http://www. wapforum.org/DTD/wml_1 . 1 .xml\">"); 
out.println("<wml>°); 

out. pri ntl n ("< !--############### Error //////////////////////////////////////////// -> "); 
30 out.println("<head> "); 

out.println("<meta http-equiv=\"Cache-Control\" content=\"max-age=0\7> "); 

out.println("</head> "); 

out.println("<card>"); 

outprintlnf <do type=\"accept\"> "); 
35 out.println(" <go method=\"post\" href=\"emitsdkwml?page=Menu\7>"); 

out.println(" </do>"); 

out.println(" <p>"); 

out.println(" Value entered must be between 0 and 255<br/> <br/>"); 
out.println(" Please press OK to return to Menu "); 
40 out.println(" </p>"); 
out.println("</card>"); 
out.println("</wml>"); 
///////////////////////////////////////////////// 
// End wml page: "Error" 

45 } 

protected void finalize() 
{ 
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System.out.println("finalize() Called"); 

try 

{ 

jemit.disconnect(); 

5 } 

catch(Exception e) 

{ 

System.out.printlnf'Exception disconnecting: "+e); 

} 

10 } 

} 

The foregoing examples may be used in conjunction with an Apache web server and 

Caucho's Resin Java Servlet Engine, as discussed below. If the Apache web server and the 
15 gateway product available from em Ware are to be installed on the same computer, one of 

them is to be associated with a port other than port 80 because they do not share this port. 

HTTP TUNNELING Example 

The following example is an example showing HTTP Tunneling and demonstrating 

how to use a Java applet to communicate with a Java servlet, which in turn will communicate 
20 with a device on em Ware's emGateway™ product of EMIT 4.0. The following pieces of 

source code will be referred to in the description. The following code will be referred to as 

the file AppServDemo.html 

<html> 
<head> 

25 <title>Applet To Servlet Communication Demo</title> 
</head> 

<bodybgcolor="#000000"> 

<appiet name="demoAppToServ" width="403" height="439" 

code="AppToServlet.class" archive="demoAppToServlet.jar"> 
30 <param name-'servletuif value="http://10.1 .1 .28:80/servlet/EmitServlet4"> 

</applet> 

</body> 
</html> 



35 The following source code will be referred to as the file AppToServletjava. In this 

example, the following applet communicates with EmitServlet via HTTP Tunneling which 

will communicate with the emGateway™ software. 

// java imports 
import java.io.*; 
40 importjava.net.*; 
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import java.awt*; 
import java.applet.*; 
import java.awtevent.*; 



5 // emWare imports 

import emJava20.emCore *; 
. import emJava20.emClient*; 

import emJava20.emAWT.emBevelPanel; 

import emJava20.emDisplays.emBarDisplay; 
1 0 import emJava20.emSliders.emKnob; 

import emJava20.emAWT.emTransparentPanel; 

import emJava20.emSwitches.emLEDSwitch; 



public class AppToServlet extends Applet implements java.awt.event. Action Listener 
15 { 

boolean appletRunning = true;//flag if this applet is running 
int mode; // used to track the value of the device mode 
DeviceSettings devSettings;//object that represents the device status values 
ServletMonitor serMonitor; //thread that provides communication to the servlet 
20 GreenLedListener greLedListener; // listens for changes to the Green LED in this applet 
RedLedListener redLedListener; // listens for changes to the Red LED in this applet 
ModeListener modeListener; // listens for changes to the Mode in this applet 
ButtonListener buttonListener; // listens for the Button push in this applet 

25 // BEGIN declare emObject controls for visual layout 

emJava20.emAWT.emBevelPanel emBevelPaneM = new emJava20.emAWT.emBevelPanel(); 

emJava20.emSliders.emKnob redKnob = newemJava20.emSliders.emKnob(); 

emJava20.emSliders.emKnob greenKnob = new emJava20.emSliders.emKnob(); 

emJava20.emAWT.emBevelPanel emBevelPanel2 = newemJava20.emAWT.emBevelPanel(); 
30 emJava20.emDisplays.emBarDisplay greenBarDisplay = new emJava20.emDisplays.emBarDisplay(); 

emJava20.emDisplays.emBarDisplay redBarDisplay = new emJava20.emDisplays.emBarDisplay(); 

emJava20.emAWT.emBevelPanel emBevelPanel3 = new emJava20.emAWT.emBevelPanel(); 

emJava20.emSwitches.emLEDSwitch localSwitch = new emJava20.emSwitches.emLEDSwitch(); 

emJava20.emSwitches.emLEDSwitch recordSwitch = new emJava20.emSwitches.emLEDSwitch(); 
35 emJava20.emSwitches.emLEDSwitch remoteSwitch = newemJava20.emSwitches.emLEDSwitch(); 

emJava20.emSwitches.emLEDSwitch playbackSwitch = newemJava20.emSwitches.emLEDSwitch(); 

emJava20.emAWT.emBevelPanel emBevelPanelS = new emJava20.emAWT.emBevelPanel(); 

emJava20.emCore.emVariable redVariable = new emJava20.emCore.emVariable(); 

emJava20.emCore.emVariable greenVariable = newemJava20.emCore.emVariable(); 
40 // END declare controls 



/*init() 

called by the browser or applet viewer to inform this applet that it has been loaded into the system... 
initializes the applet 
45 */ 

public void init() 
{ 
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// instantiate the DeviceSettings object 
devSettings = new DeviceSettings(); 

// instantiate the ServietMonitor thread [with this applet and the devSettings object] 
serMonitor = new ServletMonitor(this, devSettings); 
// cause the serMonitor thread to begin execution 
serMonitor.start(); 

// instantiate the object for each of the listeners 
greLedListener = newGreenLedListener(this, serMonitor); 
redLedListener = new Redl_edListener(this, serMonitor); 
modeListener = new ModeListener(this, serMonitor); 
buttonListener = new Button Listener(this, serMonitor); 
////////////////////////^^^^ 

// BEGIN initializing the visual layout/controls of this applet 
setLayout(null); 

setBackground(java.awt.Color.black); 

$613126(403,439); 

// Bevel Panell 

emBevelPanell .setBorderlnsets(new java.awt.lnsets(5,5,5,5)); 

emBevelPanell .selabelfLED Control"); 

emBevelPanell.setLabelVisible(true); 

emBevelPanell .selayout(null); 

add(emBevelPanell); 

emBevelPanell .setBackground(java.awt.Color.lightGray); 
emBevelPanell .setBounds(25,55 J 145 I 275); 
//Red Knob 

redKnob.setKnobBevelThickness(3); 

redKnob.setMaxEventRate(255); 

redKnob.setLabelVisible(true); 

redKnob.setLabel("Red"); 

redKnob.setLabelPosition(1 ); 

redKnob.setUpdateContinuously(true); 

redKnob.setMax(255); 

emBevelPanell .add(redKnob); 

redKnob.setBackground(java.awt.Color.white); 

redKnob.setForeground(java.awtColor.black); 

redKnob.setBounds(5,5 l 115 l 115); 

// Green Knob 

greenKnob.setKnobBevelThickness(3); 

greenKnob,setLabelVisible(true); 

greenKnob.setLabelfGreen"); 

greenKnob.setLabelPosition(1 ); 

greenKnob.setUpdateContinuously(true); 

greenKnob.setMax(255); 

emBevelPanell .add(greenKnob); 

greenKnob.setBackground(java.awt.Colorwhite); 

greenKnob.setForeground(java.awt.Color.black); 

greenKnob.setBounds(5, 1 25, 1 1 5, 1 1 5); 
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// Bevel Panel 2 

emBevelPanel2.setBorderlnsets(newjava.awt.lnsets(5 ) 5 J 5,5)); 

emBevelPanel2.setLabel("LED Display"); 

emBevelPanel2.setLabelVisible(true); 

emBeveIPanel2.setLayout(null); 

add(emBevelPanel2); 

emBevelPanel2.setBackground(java.awt.Color.lightGray); 

emBevelPanel2.setBounds(1 70,55,21 0,275); 

// Green Bar Display 

greenBarDisplay.setLabel("Green"); 

greenBarDisplay.setThresholdVisible(false); 

greenBarDisplay.setThreshold2Color(java.awt.Color.green); 

greenBarDisplay.setThreshold1Color{java.awt.Color.green); 

greenBarDisplay.setLabelVisible(true); 

greenBarDisplay.setMinMaxVisible(false); 

greenBarDisplay.setMax(255); 

emBevelPanel2.add(greenBarDisplay); 

greenBarDisplay.setBackground{java.awt.Color.white); 

greenBarDisplay.setForeground(java.awt.Color.black); 

greenBarDisplay.setBounds(96,5,90,235); 

// Red Bar Display 

redBarDisplay.setThresholdOColor(java.awt.Color.red); 

redBarDisplay.setLabel("Red"); 

redBarDisplay.setThresholdVisible(false); 

red BarDisplay .setThreshold 1 Color(java . awt. Co lor. red) ; 

redBarDisplay.setLabelVisible(true); 

redBarDisplay.setMinMaxVisible(false); 

redBarDisplay.setMax(255); 

emBevelPanel2.add(redBarDisplay); 

redBarDisplay.setBackground(java.awl.Color.white); 

redBarDisplay.setForeground{java.awt.Color.black); 

redBarDisplay.setBounds(5,5,90,235); 

// Bevel Panel 3 

emBevelPanel3.setBorderlnsets(newjava.awl.lnsets(5,5 ) 5,5)); 

emBevelPanel3.setLabel("Change Mode"); 

emBevelPane!3.setLabelVisible(true); 

emBevelPanei3.setLayout(null); 

add(emBevelPanel3); 

emBevelPanei3.setBackground(java.awt.Color.lightGray); 

emBevelPanel3.setBounds(25 ) 330 J 355,85); 

// Local Switch 

localSwitch.setActiveLabel("Local"); 

localSwitch.setlnactiveLabel("Local"); 

emBevelPanel3.add(localSwitch); 

localSwitch.setBackground(java.awt.Color.white); 

localSwitch.setBounds(5 J 5,70 J 45); 

// Record Switch 
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recordSwitch.setActiveLabel("Record"); 
recordSwitch.setlnactiveLabel("Record"); 
emBevelPanel3.add(recordSwitch); 
recordSwitch.setBackground(java.awt.Color.white); 
5 recordSwitch.setBounds(90,5,70,45); 

remoteSwitch.setActiveLabelfRemote"); 
remoteSwitch.setlnactiveLabel("Remote"); 
emBevelPanel3.add(remoteSwitch); 
// Remote Switch 

10 remoteSwitch.setBackgroundGava.awt.Color.white); 

remoteSwitch.setBounds(260,5,70,45); 

// Playback Switch 

playbackSwitch.setMomentary(true); 

playbackSwitch.setActiveLabel("Playback"); 
15 playbackSwitch.setlnactiveLabelfPlayback"); 

emBevelPane!3.add(playbackSwitch); 

playbackSwitch.setBackground(java.awt.Color.white); 

playbackSwitch.setBoimds(175,5,70,45); 

// Bevel Panel 5 

20 emBevelPanel5.setBorderlnsets(newjava.awl.lnsets(5,5 ) 5 } 5)); 

emBevelPanel5.setLabel("emWare SDK Demo Control Panel"); 

emBevelPanel5.setLabelVisible(true); 

emBevelPanel5.setLayout(null); 

add(emBevelPanel5); 
25 emBevelPanel5.setBackground(java.awt.Color.lightGray); 

emBevelPanel5.setFont(new FontC'Dialog", Font.BOLD, 20)); 

emBevelPanel5.setBounds(1 2, 1 2,380,41 5); 

// Red and Green Variable 

redVariable.setVariableName("Red"); 
30 greenVariable.setVariableName("Green"); 

// END initializing the visual layout/controls 

//BEGIN register listeners 

/* when an event is performed on these listners 
the method actionPerformed() is called */ 
35 redVariable.addActionListener(this); 

greenVariable.addActionListener(this); 

localSwitch.addActionListener(this); 

recordSwitch.addActionListener(this); 

playbackSwitch.addActionListener(this); 
40 remoteSwitch.addActionListener(this); 

redKnob.addActionListener(this); 

greenKnob.addActionListener(this); 

// END register listeners 

} 

45 

/* destroyQ • 



called by the browser or applet viewer to inform this applet that it is being 
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reclaimed and that it should destroy any resources that it has allocated. 
*/ 



public void destroy() 
{ 

5 appletRunning = false; 

try 

{ 

Thread.sleep(1000); 

} 

10 catch (Exception e) {} 

devSettings = null; 

serMonitor = null; 

greLedListener = null; 

redLedListener = null; 
15 modeListener = null; 

System.gc(); // run the system garbage collector 

try 

{ 

Thread.sleep(1000); 

20 } 

catch (Exception e) {} 

} 

/* processEventQ 



45 



25 processes events for this applet 

*/ 

public void processEvent(String device Var, int val) 
{ 

/* if device Var is "Mode" then call internal 
30 function setjnodeO to set mode to val 

*/ 

if( deviceVar.equalsf'Mode") ) 
{ 

set_mode(val); 

35 } 

/* if deviceVar is "Red" then set the redBarDisplay to val... 

...and if mode is zero then set redKnob to val 

*/ 

40 else if( deviceVar.equals("Red") ) 

{ 

redBarDisplay.setValue(val); 

if( mode == 0 ) redKnob.setValue(val); 

} 



/* if deviceVar is "Green" then set the greenBarDisplay to val... 

...and if mode is zero then set greenKnob to val 
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*/ 

else if( deviceVar.equals("Green") ) 

{ 

greenBarDisplay.setValue(val); 
5 if( mode == 0 ) greenKnob.setValue(val); 

} 

} 

/* set_mode() 

1 0 changes the value of mode and makes 

all necessary changes to the applet 
*/ 

private void set_mode(int newMode) 

{ 

1 5 mode = newMode; // set the global device mode to newMode 



/* set knobs and switchs on the applet to 

reflect the new state of the device mode 

7 

20 switch(newMode) 
{ 

case 0: /* Local Mode: 
set local switch active and all others inactive */ 

greenKnob.setEnabled(false); 
25 redKnob.setEnabled(false); 

localSwitch.setActive(true); 
recordSwitch.setActive(false); 
playbackSwitch.setActive(false); 
remoteSwitch.setActive(false); 
30 break; 

case 1:/* Record Mode: 
set record switch active and all others inactive 

7 

greenKnob.setEnabled(false); 
35 redKnob.setEnabled(false); 

localSwitch.setActive(false); 
recordSwitch.setActive(true); 
playbackSwitch.setActive(false); 
remoteSwitch .setActive(false); 
40 break; 

case 2: /* Playback Mode: 
set playback switch active and ail others inactive 

7 

greenKnob.setEnabled(false); 
45 redKnob.setEnabled(false); 

localSwitch.setActive(false); 
recordSwitch.setActive(false); 
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playbackSwitch .setActive(true); 

remoteSwitch.setActive(false); 

break; 

case 3: /* Remote Mode: 

set green and red knobs active, 
set remote switch active, 
and all others inactive 

7 

greenKnob.setEnabled(true); 

redKnob.setEnabled(true); 

localSwitch .setActive(false); 

recordSwitch.setActive(false); 

playbackSwitch.setActive(false); 

remoteSwitch.setActive(true); 

} 

} 

/* actionPerformed() 

called when an event is performed on any of the 
listeners, which were defined in the init() method above 
*/ 

public void actionPerformed{java.awt.event.ActionEvent event) 

{ 

/* call the appropriate actionPerformed method 
associated with the object of this event... each of the actionPerformed methods are defined 

7 

Object object = event.getSource(); 
if (object == redVariable) 

redVariable_actionPerformed(event); 
else if (object == greenVariable) 

greenVariable_actionPerformed(event); 
else if (object == localSwitch) 

localSwitch„actionPerformed(event); 
else if (object == recordSwitch) 

recordSwitch_actionPerformed(event); 
else if (object == playbackSwitch) 

playbackSwitch„actionPerformed(event); 
else if (object == remoteSwitch) 

remoteSwitch_actionPerformed(event); 
else if (object == redKnob) 

redKnob_actionPerformed(event); 
else if (object == greenKnob) 

greenKnob_actionPerformed(event); 

} 

/* redVariable_actionPerformed() 
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10 



20 



called when an event is performed 
on the redVariable action listener 
*/ 

void redVariable_actionPerformed{java.awt.event.ActionEvent event) 

{ 

try 
{ 

redBarDisplay.setValue(redVariable.getlntValue()); 
redKnob.setValue(redVariable.getlntValue()); 



/* set the red value in the ServletMonitor class 

so that the next time the serMonitor thread 
communicates to the servlet it will change the 
value of the red variable on the device. 

15 */ 

serMonitor.red = redVariable.getlntValue(); 

} 

catch (java.lang.Exception e) {} 



} 



/* greenVariable_actionPerformed() 

called when an event is performed 

on the greenVariable action listener 
*/ 

25 void greenVariable_actionPerformed(java.awt.event.ActionEvent event) 

{ 

try 

{ 

greenBarDisplay.setVaiue(greenVariable.getlntValue()); 
30 greenKnob.setValue(greenVariable.getlntValue()); 

/* set the green value in the ServletMonitor class 
so that the next time the serMonitor thread 
communicates to the servlet it will change the 
35 value of the green variable on the device. 

*/ 

serMonitor.green = greenVariable.getlntValue(); 

} 

catch (java.lang.Exception e) {} 



40 } 



/* locaiSwitch_actionPerformed() • 



called when an event is performed 
on the localSwitch action listener 
45 */ 

void localSwitch„actionPerformedOava.awt.event.ActionEvent event) 
{ 
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/* if localSwitch is NOT already active and if the 

mode value is two then set localSwitch TRUE... 

7 

if( ! localSwitch . isActi ve() && mode == 3 ) 
5 localSwitch.setActive(true); 

/* set mode value to zero, 

call invokeFunction() method of the modeListener class, 
and then set all other switches false 

10 7 

mode - 0; 

modeListener.invokeFunction(mode); 
recordSwitch.setActive(false); 
playbackSwitch.setActive(false); 
1 5 remoteSwitch .setActive(false); 

} 

/* recordSwitch_actionPerformed() 

called when an event is performed 
20 on the recordSwitch action listener 

*/ 

void recordSwitch_actionPerformed(java.awt.event.ActionEvent event) 
{ 

/* if recordSwitch is NOT already active and if the 
25 mode value is one then set recordSwitch TRUE... 

7 

if( !recordSwitch.isActive() && mode == 1 ) 
recordSwitch.setActive(true); 

30 /* otherwise- 

set mode value to one, 

call invokeFunctionQ method of the modeListener class, 
set all other switches false, 
and then call buttonl_istener() method of the 
35 setVariable class, which will activate 

record functionality on the device 

7 

else 
{ 

40 mode = 1; 

modeListener.invokeFunction(mode); 

localSwitch.setActive(false); 

playbackSwitch.setActive(false); 

remoteSwitch.setActive(false); 
45 buttonl_istener.setVariable(1 ); 



} 
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/* playbackSwitch_actionPerformed() 

called when an event is performed 
on the playbackSwitch action listener 
5 . */ 

void playbackSwitch_actionPerformedOava.awt.event.ActionEvent event) 
{ 

/* if playbackSwitch is NOT already active and if the 

mode value is two then set playbackSwitch TRUE... 

10 */ 

if( ! playbackSwitch . isActi ve() && mode == 2 ) 
playbackSwitch .setActive(true); 

/* otherwise... 
15 set mode value to two, 

call invokeFunction() method of the modeListener class, 
set all other switches false, 
and then call button Listener() method of the 
setVariable class, which will activate 
20 playback functionality on the device 

7 

else 
{ 

mode = 2; 

25 modeListener.invokeFunction(mode); 

locals witch. setActive(false); 
record Switch. setActive(false); 
remoteSwitch.setActive(false); 
buttonListener.setVariable(l); 



30 



} 



/* remoteSwitch_actionPerformed() 

called when an event is performed 
35 on the remoteSwitch action listener 
*/ 

void remoteSwitch_actionPerformed(java.awt.event.ActionEvent event) 

{ 

/* if remoteSwitch is NOT already active and if the 
40 mode value is two then set remoteSwitch TRUE... 

7 

if( !remoteSwitch.isActive() && mode == 3 ) 
remoteSwitch .setActive(true); 

45 /* set mode value to three, 

call invokeFunction() method of the modeListener class, 
and then set all other switches false 
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35 



7 

mode = 3; 

modeListener.invokeFunction(mode); 
locals witch .setActive(false) ; 
playbackSwitch .setActive(false); 
recordSwitch.setActive(false); 

} 

/* redKnob_actionPerformed() 



10 called when an event is performed 

on the redKnob action listener 

*/ 

void redKnob_actionPerformed{java.awt.event.ActionEvent event) 
{ 

15 try 
{ 

redVariable.setlntValue(redKnob.getValue()); 

} 

catch (java.lang. Exception e) {} 

20 } 

/* greenKnob_actionPerformed() 

called when an event is performed 

on the greenKnob action listener 

25 */ 

void greenKnob_actionPerformedGava.awt.event.ActionEvent event) 
{ 

try 

{ 

30 greenVariable.setlntValue(greenKnob.getValue()); 
} 

catch (java.lang.Exception e) {} 

} 

//BEGIN INNER CLASSES 



/* class ServletMonitor- 



separate thread that monitors the servlet 
for changes and sends any changes made in 
this applet via HTTP 

class ServletMonitor extends Thread 
{ 

public int 

green = -1, 
45 red = ~1, 

mode = -1 , 
button = -1; 
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public int 

greenOldFromServer = -1 , 
redOldFromServer = -1 ) 
5 modeOldFromServer = -1 ; 

public int 

greenNewFromServer = -1 , 
redNewFromServer = -1 , 
1 0 modeNewFromServer = -1 ; 

AppToServlet theApplet; 
DeviceSettings devSettings; 

1 5 public ServletMonitor(AppToServlet app, DeviceSettings ds) 

{ 

theApplet = app; 
devSettings = ds; 

} 

20 

/* ServletMonitor Member Function: run() 

called when this thread is started 
. */ 

public void run() 
25 { 

String s; 

String servletURL; 
URLu; 

30 URLConnection uric; 

BufferedReader in; 



35 



// get the URL of the EMIT activated servlet 
servletURL = getParameter("servleturl"); 



I* if getParameter("servleturr) returned 

null then hard code the servletURL 

NOTE: the servlet URL MUST be an absolute URL!!! 

*/ 

40 if (servletURL == null) servletURL = H http://10.1.1.28:80/servlet/EmitServlet"; 

try 
{ 

while (theApplet.appletRunning) 
45 { 

/* if remote mode is active then get the green 

and red values from the green and red knobs 
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*/ 

if (theApplet.mode == 3) 
{ 

green = theApplet.greenKnob.getValue(); 
5 red = theApplet. red Knob.getValue(); 

} 

/* declare a new URL object in which 
we will pass the values of the 
1 0 device variables in a query string 

*/ 
s = 

( ,l green= ,, +green+ ,, &red="+red+ ,, &mode="+mode+ ll &button="+button); 

u = new URL(servletURL+"?"+s); 



15 



20 



// BEGIN Servlet communication 
/* assign to 'uric' a URLConnection object that represents a 
connection to the remote object referred to by the URL object */ 

uric = u.openConnection(); 



/*set the value of doOutput field for this URLConnection to false... 
A URL connection can be used for input and/or output. 
Setting the doOutput flag to false indicates that the application 
does NOT intend to write data to the URL connection. */ 
25 urlc.setDoOutput(false); 

/* set the value of dolnput field for this URLConnection to true... 

A URL connection can be used for input and/or output. 
Setting the dolnput flag to true indicates that the application 
30 intends to read data from the URL connection. */ 

urlc.setDolnput(true); 

/*set value of allowUserlnteraction of this URLConnection to false. 
If allowUserlnteraction is set to false then no user interaction is allowed. */ 
35 urlc.setAllowUserlnteraction(false); 

/* assign to 'in' a BufferedReader object that reads text from the 

character-input stream received from the InputStream of 
the URLConnection -- buffering characters so as to provide 
40 for the efficient reading of characters, arrays, and lines. */ 

in = new Buffered Reader(new 
lnputStreamReader(urlc.getlnputStream())); 

/* assign to 's' a String containing the contents of the next 
45 line of text received from the BufferedReader object */ 

s = in.readLineQ; 
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// close the stream 
in.close(); 

// END Servlet communication 
5 /* call the function serverStringParser() which will parse 

the data received from the Buffered Reader object and use 
this data to obtain the new values of the devices settings 7 

if (s != null) serverStringParser(s); 

1 0 // reinitialize the device settings 

green = -1; 
red = -1; 
mode = -1; 
button = -1; 

15 

//THIS IS WHERE THE POLL RATE IS SET; 
/* cause this thread to temporarily cease execution for 100 milliseconds... 
This thread (ServletMonitor) will initiate communication to the servlet again in 100 milliseconds. If the 
thread does not sleep then the continues steam to the server will bog down the efficiency of the servlet. 

20 7 

Thread.sleep(100); 
//END POLL RATE SET 

} 

25 } 

catch(Exception e) 

{ 

System.out.println(e); 

} 

30 } 

/* ServletMonitor Member Function: serverStringParser() — 

parse the input String and use the parsed data 

to set the values of the devices settings 
35 */ 

public void serverStringParser(String s) 

{ 

int 

firstEquals, 

40 secondEquals, 

thirdEquals; 

int 

firstAmpersand, 
secondAmpersand, 
45 thirdAmpersand; 



/* find the string index positions of the '=' characters 
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used to separate the name=value pair of the devices settings */ 
firstEquals = s.indexOf((int) '=', 0); 
secondEquals = s.indexOf((int) '=', (firstEquals+1)); 
thirdEquals = s.indexOf((int) '-, (secondEquals+1)); 

5 

/* find the string index positions of the '&' characters 

used to separate the devices settings from the input String */ 

firstAmpersand = s JndexOf((int) '&', 0); 

secondAmpersand = s.indexOf((int) '&', (firstAmpersand+1)); 
10 thirdAmpersand = s.indexOf((int) '&', (secondAmpersand+1)); 

/* assign the new 'green', 'red', and 'mode' values from the server 
by parsing input string using the indexed positions found above 7 

greenNewFromServer = lnteger.parseint(s.substring((firstEquals+1), 

15 firstAmpersand)); 

redNewFromServer = lnteger.parselnt(s.substring((secondEquals+1), 

secondAmpersand)); 

modeNewFromServer = lnteger.parselnt(s.substring((thirdEquals+1) J 

thirdAmpersand)); 

20 

/* if the new Green value is not the same as the old Green value then process an event in this applet 

for the Green device setting and assign greenNewFromServer to greenOldFromServer for the next 

run */ 

if (greenOldFromServer!=greenNewFromServer) 
25 { 

theApplet.processEvent("Green" f greenNewFromServer); 
greenOldFromServer = greenNewFromServer; 

} 

30 /* if the new Red value is not the same as the old Red value then 
process an event in this applet for the Red device setting... 
.and assign redNewFromServer to redOldFromServerforthe next run 7 
if (redOldFromServer!=redNewFromServer) 

{ 

35 theAppletprocessEventf'Red", redNewFromServer); 

redOldFromServer = redNewFromServer; 

} 

/* if the new Mode value is not the same as the old Mode value then 
40 process an event in this applet for the Mode device setting.... and assign modeNewFromServer to 
modeOldFromServer for the next run 7 

if (modeOldFromServer!=modeNewFromServer) 

{ 

theApplet.processEvent("Mode", modeNewFromServer); 
45 modeOldFromServer = modeNewFromServer; 

} 

} 
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10 



/* class GreenLedListener 

listens for clientside changes to the Green LED 

*/ 

class GreenLedListener implements ActionListener 
{ 

AppToServlet theApplet; 
ServletMonitor serMonitor; 



public GreenLedListener(AppToServlet app, ServletMonitor sm) 
{ 

serMonitor = sm; 
theApplet = app; 

15 } 

/* GreenLedListener Member Function: actionPerformed() 

parse the integer value from the command string 
associated with this action... ensure that the value 
20 is within range... and then set the green value in 
the ServletMonitor class so that the next time the 
serMonitor thread communicates to the servlet it will 
change the value of the red variable on the device 
__*/ 

25 public void actionPerformed(ActionEvent ae) 

{ 

int i = lnteger.parselnt(ae.getActionCommand()); 

if(i<0) 

{ 

30 i = 0; 

} 

else if ( i > 255 ) 
{ 

i = 255; 

35 } 

serMonitor.green = i; 

} 



40 /* class RedLedListener ■ 



listens for clientside changes to the Red LED 

*/ 

class RedLedListener implements ActionListener 

{ 

45 AppToServlet theApplet; 

ServletMonitor serMonitor; 



-44- 



public Redl_edListener(AppToServlet app, ServletMonitor sm) 
{ 

serMonitor = sm; 
theApplet = app; 

} 

/* RedLedListener Member Function: actionPerformedQ 



parse the integer value from the command string 
associated with this action... ensure that the value 
10 is within range... and then set the red value in 

the ServletMonitor class so that the next time the 
serMonitor thread communicates to the servlet it will 
change the value of the red variable on the device 
*/ 

15 public void actionPerformed(ActionEvent ae) 

{ 

int i = lnteger.parselnt(ae.getActionCommand()); 

if(i<0) 

{ 

20 i = 0; 

} 

else if ( i > 255 ) 
{ 

i = 255; 

25 } 

serMonitor.red = i; 

} 



30 /* class ModeListener - 



listens forclientside changes to the Mode 

*/ 

class ModeListener 
{ 

35 AppToServlet theApplet; 

ServletMonitor serMonitor; 

public ModeListener(AppToServlet app, ServletMonitor sm) 
{ 

40 serMonitor = sm; 

theApplet = app; 

} 



/* ModeListener Member Function: invokeFunction() 

45 ensure that the value of the input integer is within range... and then set the mode 

value in the ServletMonitor class so that the next time the serMonitor thread 
communicates to the servlet it will change the value of the mode variable on the device 
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*/ 

public void invokeFunction(int i) 

{ 

if(KO) 
5 { 

1 = 0; 

} 

else if ( i > 3 ) 
{ 

10 i = 3; 

} 

serMonitor.mode = i; 

} 

} 

15 

/* class ButtonListener 

listens for clientside changes to the Mode 

*/ 

20 class ButtonListener 

{ 

AppToServlet theApplet; 
ServletMonitor serMonitor; 

25 public ButtonListener(AppToServlet app, ServletMonitor sm) 

{ 

serMonitor = sm; 
theApplet = app; 

} 

30 

/* ButtonListener Member Function: setVariable() 

ensure that the value of the input integer is within range... 
and then set the button value in the ServletMonitor class 
so that the next time the serMonitor thread communicates 
35 to the servlet it will change the value of the button 
variable on the device 

*/ 

public void setVariable(int i) 
{ 

40 if(i!=1) 

{ 

i = 1; 

} 

serMonitor.button = i; 

45 } 
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/* class DeviceSettings ■ 



this is a virtual representation of the objects settings/status 
*/ 



5 class DeviceSettings 

{ 

public int 

greenLed, 
redLed, 

10 mode, 

knob; 

// green 

public int getGreenl_ed() 
15 { 

return greenLed; 

} 

public void setGreenLed(int i) // from device 
{ 

20 greenLed = i; 

} 

//red 

public int getRedLed() 
25 { 

return redLed; 

} 

public void setRedLed(int i) // from device 

{ 

30 redLed = i; 

} 

// mode 

public int getMode() 
35 { 

return mode; 

} 

public void setMode(int i) // from device 
{ 

40 mode = i; 

} 

//knob 

public int getKnob() 
45 { 

return knob; 

} 
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public void setKnob(int i) // from device 
{ 

knob - i; 

} 

5 } 

//END INNER CLASSES 

liiiiiiiiiiiiiiiiiiiiiiiiiim 

> 

The following source code will be referred to as the file EmitServlet4.java. In this 
10 example, the following servlet acts as a communication link between the AppToServlet applet 
and the emGateway™ software on EMIT 4.0. 

// java imports 
import java.io.*; 
15 import javax.servlet*; 
import javax.servlet http.*; 

// emWare imports 

import com.emWare.emClient.*; 

20 

public class EmitServlet4 extends HttpServlet 
{ 

// 

// — these properties are used by the JEmit object to connect to the emGateway — 
25 // 

// the IP address or name of the emGateway host computer 

private String host_str = "10.1.1.28"; 

// the emGateway HTTP port 

private int port_num = 80; 
30 // the device string 

private String device_str = "a=sdkboard"; 

// the username that the JEmit object is using to connect to emGateway 
private String username = "admin"; 
35 // the password (associated with username) on the emGateway computer 

private String password = "admin"; 

// 

// 



40 private String 

mode, // used to track the device mode value from the applet 

button, // used to track the button push value from the applet 

green, // used to track the green value from the applet 

red; // used to track the red value from the applet 

45 

/* flag if this servlet is connected to the emGateway: 
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initialized to false so that we don't set 

the values in the applet until this servlet 

has successfully connected to the emGateway 

7 

5 private boolean connected = false; 

EmitHandler emiHandler; // thread that provides communication to the emGateway 
BoardModel theDeviceModel; // provides a model for the values on the physical device 
DeviceSetter devSetter; // provides a mechanism to set values on the physical device 
10 DeviceUpdated devUpdated; // makes changes to the BoardModel object when the physical 

device changes 

/* jnitQ 

Called by the servlet container to indicate 

15 that the servlet is being placed into service... 

initializes this servlet 
*/ 

public void init(ServletConfig config) throws ServletException 

{ 

20 // we must call super.init(config) when overriding this form of the method init() 

superinit(config); 



// instantiate the BoardModel object 
theDeviceModel = new BoardModelQ; 



25 



/* instantiate and then initialize the DeviceSetter 
object with the BoardModel object 

7 

devSetter = new DeviceSetter(theDeviceModel); 
30 theDeviceModel.setDevSetter(devSetter); 

// instantiate the DeviceUpdated object with the BoardModel object 
devUpdated = new DeviceUpdated(theDeviceModel); 

35 /* instantiate and then initialize the EmitHandler object 

with the DeviceUpdated object and the BoardModel object 

7 

emiHandler = new EmitHandler(devUpdated, theDeviceModel); 
devSetter.setEmitHandler(emiHandler); 



40 



// cause the emiHandler thread to begin execution 
emiHandler.startQ; 



//just a helpful system message 
45 System.out.println("EmitHandler thread is running..."); 
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/*doGet() -™ 

called by the server (via the service method) 
to allow the servlet to handle a GET request 

*/ 

5 public void doGet(HttpServletRequest req, HttpServletResponse res) 

throws ServletException, lOException 

{ 

/* only continue if the connected flag is true so that 
we don't set the values in the applet until this 
10 servlet has successfully connected to the emGateway... 

NOTE: the run() method of the AppToServlet applet 
will continue to call on this servlet in 

the ServletMonitor thread; so once the servlet 
has successfully connected to the emGateway 
1 5 the embedded device variables will be updated 

*/ 

if (connected) 
{ 

/* set the content type of the response 
20 being sent to the client as "text/html" 

to prepare for obtaining a PrintWriter 

*/ 

res.setContentTypeftext/htmr); 

25 // assign a PrintWriter object that can send character text to the client. 

PrintWriter out = res.getWriter(); 

/* assign String values to each of the embedded device variables from 
the request parameters contained in the query string 

30 */ 

String green = (String) req.getParameterfgreen"); 
String red = (String) req.getParameter("red"); 
String mode = (String) req.getParameterfmode"); 
String button = (String) req.getParameterf'button"); 

35 

/* if the green value does not equal -1 then call 

the setGreenLed() function of the BoardModel object 

*/ 

if(!(green.equals("-1"))) 
40 { 

theDeviceModel.setGreenLed(lnteger.parselnt(green)); 

} 

I* if the red value does not equal -1 then call 
45 the setRedLed() function of the BoardModel object 

*/ 

if(!(red.equals("-1"))) 
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{ 

theDeviceModel.setRedLed(lnteger.parselnt(red)); 

} 

5 /* if the mode value does not equal -1 then call 

the setMode() function of the BoardModel object 

*/ 

if(!(mode.equals("-1"))) 
{ 

10 theDeviceModel.setMode(lnteger.parselnt(mode)); 

} 

/* if the button value does not equal -1 then call 

the setButton() function of the BoardModel object 

15 */ 

if ( button != null && ( !(button.equals("-1")) )) 

{ 

theDeviceModel.setButton(lnteger.parselnt(button)); 

} 

20 

/* print the servlet response output which will 

be communciated back to the AppToServlet applet 

*/ 

out.print( "green=" + ( theDeviceModel.getGreenLed() ) ); 
25 out.print( "&red=" + ( theDeviceModel.getRedLed() ) ); 

out.print( "&mode=" + ( theDeviceModel.getMode() ) ); 
out.println( "&button=" + ( theDeviceModel.getButtonQ ) ); 



30 



} 

/*doPost() 

called by the server (via the service method) 
to allow a servlet to handle a POST request 
*/ 

35 public void doPost(HttpServletRequest req, HttpServletResponse res) 

throws ServletException, lOException 

{ 

// make a call to the doGet() method just incase a POST request was made instead 
doGet(req, res); 

40 } 

/* class EmitHandler 

separate thread that establishes a connection 

to the emGateway, acting as a communication link 

between the AppToServlet applet and the emGateway 
45 */ 

class EmitHandler extends Thread implements EmbeddedListener 
{ 
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DeviceUpdated devUpdated; 
BoardModel devModel; 

JEmit emitObj; // provides a mechanism to communicate with the physical device 

5 public EmitHandler(DeviceUpdated du, BoardModel dm) 

{ 

devUpdated = du; 
devModel = dm; 

1 0 // just a helpful system message 

System.out.println(The EmitHandler is constructed..."); 

} 

/* EmitHandler Member Function: run() 

1 5 called when this thread is instantiated 
*/ 

public void run() 

{ 

// instantiate the JEmit object 
20 emitObj = newJEmit(); 

//just a helpful system message 
System.out.println("The JEmit was constructed \n"); 

25 /* set the host field with the IP address 

or name of the emGateway host computer 

*/ 

emitObj.setHost(host_str); 

30 /* set the port field with 

the emGateway HTTP port 

*/ 

emitObj.setPort(portjium); 

35 /* set the device name 

with the device string 

*/ 

emitObj.setDevice(device_str); 

40 r set the username field with the username that 

the JEmit object is using to connect to emGateway 

*/ 

emitObj.setUsername(username); 

45 /* set the password field with the password 

(associated with username) on the emGateway computer 

*/ 
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emitObj.setPassword(password); 



10 



try 
{ 



/* connect to the remote device 

(using host, device, port, username, 
and password which were set above). 

*/ 

emitObj.connect(); 



// just a helpful system message 
System.out.println("\nConnected to " + device_str + " on " + host_str + ":" + port_num); 

} 

catch(JEmitException e) 
15 { 

System.outprintln("could not connect... " + e); 

} 

// add this servlet to the JEmit object as an EmbeddedListener 
20 emitObj.addEmbeddedListener(this); 

try 
{ 

// subscribe to the embedded device variables in the JEmit object 
25 emitObj.subscribeVariable("Green n ); 

emitObj.subscribeVariableC'Red 11 ); 
emitObj.subscribeVariable("Mode"); 

} 

catch(JEmitException e) 
30 { 

System.out.println("could not subscribe to variable" + e); 

} 

try 

35 { 

// forces all embedded device variables to report their current value 
emitObj.updateAIIVariables(); 

} 

catch(JEmitException e) 
40 { 

System.out.println("could not update all variables... " + e); 

} 

//set the connected flag 
45 if (emitObj.isConnected()) 

{ 

connected = true; 
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} 

else { 

connected = false; 

} 

5 } 

/* EmitHandler Member Function: destroy() 

called by the servlet container to indicate 
to the servlet that it is being taken out 
1 0 of service and that it should destroy any 
resources that it has allocated 
*/ 

public void destroy() 
{ 

15 try{Thread.sleep(1000);} catch(Exception e) {System.out.println("sleep:"+e);} 

try 

{ 

emitObj.disconnect(); 

20 } 

catch(JEmitException e) 

{ 

System.out.printlnfthere was a problem at disconnect... " + e); 

} 

25 

//just a helpful system message 
System.out.println("\ndisconnected from " + device_str + " on " + host„str + ":" + portjium); 

} 

30 /* EmitHandler Member Function: embeddedVariableChanged() 

processes embedded variable changes for this servlet 
*/ 

public void embeddedVariableChanged(EmbeddedEvent evt) 
{ 

3 5 String name = evt.getName(); 

Object value = evt.getValue(); 

/* if the embedded variable event name is "Green" 

then call the updateGreenLed() method of the DeviceUpdated object 

40 */ 

if( name.equals("Green") ) 

{ 

int i = ((Short)value).intValue(); 
devUpdated.updateGreenLed(i); 

45 } 

/* if the embedded variable event name is "Red" 
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then call the updateRedLed() method of the DeviceUpdated object 

*/ 

else if( name.equals("Red") ) 
{ 

int i = ((Short)value) .intValue(); 
devllpdated.updateRedLed(i); 

} 

/* if the embedded variable event name is "Mode" 

then call the updateMode() method of the DeviceUpdated object 

*/ 

else if( name.equals("Mode") ) 
{ 

int i = ((Short)value).intValue(); 
devlipdated.updateMode(i); 

/* if the event is a mode change to local mode then set 

the red and green values of the BoardModel object 

7 

} 

} 

public void embeddedEventSignaled(EmbeddedEvent evt) 
{ 

/* Not used... This method is only implemented 

because this object is an EmbeddedListener. 

7 

} 

public void embeddedFunctionReturned(EmbeddedEvent evt) 
{ 

/* Not used... This method is only implemented 

because this object is an EmbeddedListener. 

7 

} 

/* EmitHandler Member Function: setGreenLed() 

set the green variable on the physical device 
*/ 

public void setGreenLed(int i) 

{ 

try 
{ 

emitObj.setVariablefGreen", new Integer(i)); 

} 

catch(JEmitException e) 
{ 
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System . out. println("there was a problem setting the Green variable on the device... " + e); 
} 

} 

5 /* EmitHandler Member Function: setRedLed() 

set the red variable on the physical device 
*/ 

public void setRedLed(int i) 

{ 

10 try 

{ 

emitObj.setVariable("Red", new lnteger(i)); 

} 

catch(JEmitException e) 

15 { 

System.out.printlnfthere was a problem setting the Red variable on the device... " + e); 

} 

} 

20 /* EmitHandler Member Function: setModeQ 



set the mode variable on the physical device 
*/ 

public void setMode(int i) 

{ 

25 try 

{ 

emitObj.invokeFunction("ChangeMode", new Integer(i)); 

} 

catch(JEmitException e) 
30 { 

System.out.println("there was a problem setting the Mode variable on the device... " + e); 

} 

} 

35 r EmitHandler Member Function: setButton() 



set the button variable on the physical device 
*/ 

public void setButton(int i) 
{ 

40 try 

{ 

emitObj.setVariablef'Button", new Integer(i)); 

} 

catch(JEmitException e) 

45 { 

System.out.println("there was a problem setting the Button variable on the device... " + e); 

} 
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/* class BoardModel 

5 provides a model for the values on the physical device 
_ .*/ 

class BoardModel 

{ 

public int 

10 greenLed=0, 

redLed=0, 
mode=3, 
button=0; 

1 5 private DeviceSetter devSetter; 

public void setDevSetter(DeviceSetter ds) 
{ 

devSetter = ds; 

20 

//just a helpful system message 
System.out.println(The BoardModel is constructed..."); 

} 

25 /* each of the following four methods return each 

of the four variable values of this object 

*/ 

public int getGreenl_ed() 
{ 

30 return greenLed; 

} 

public int getRedLed() 

{ 

return redLed; 

35 } 

public intgetMode() 

{ 

return mode; 

} 

40 public int getButton() 

{ 

return button; 

} 

45 /* each of the following four methods sets each 

of the four variable values of this object 

*/ 
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10 



15 



20 



25 



30 



35 



public void updatedGreenLed(int i) 

greenLed = i; 
public void updatedRedLed(int i) 

redLed = i; 
public void updatedMode(int i) 

mode - i; 
public void updated Button(int i) 
button = i; 

each of the following four methods sets each of the four 
embedded variable values of the DeviceSetter object 

*/ 

public void setGreenLed(int i) 

devSetter.setGreenLed(i); 
public void setRedl_ed(int i) 

devSetter.setRedLed(i); 
public void setMode(int i) 

devSetter.setMode(i); 
public void setButton(int i) 

devSetter.setButton(i); 



40 



45 



/* class DeviceSetter 

provides a mechanism to set values on the physical device 
*/ 



class DeviceSetter 
{ 



BoardModel theDeviceModel; 
EmitHandler theEmitHandler; 



public DeviceSetter(BoardModel ds) 
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theDeviceModel = ds; 

//just a helpful system message 
5 System.out.println("The DeviceSetter is constructed..."); 

} 

public void setEmitHandler(EmitHandler eh) 
{ 

10 theEmitHandler = eh; 

} 

/* each of the following four methods sets each of the four 
embedded variable values of the EmitHandler object 

15 */ 

public void setGreenLed(int i) 

{ 

theEmitHandler.setGreenLed(i); 

} 

20 public void setRedLed(int i) 

{ 

theEmitHandler.setRedLed(i); 

} 

public void setMode(int i) 
25 { 

theEmitHandler.setMode(i); 

} 

public void setButton(int i) 
{ 

30 theEmitHandler.setButton(i); 

} 



/* class DeviceUpdated 

35 makes changes to the BoardModel object when the physical device changes 
*/ 



40 



class DeviceUpdated 
{ 

BoardModel theDeviceModel; 

public DeviceUpdated(BoardModel ds) 
{ 

theDeviceModel = ds; 

45 // just a helpful system message 

System.out.println("The DeviceUpdated is constructed..."); 

} 
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/* each of the following three methods sets the corresponding 
embedded variable values of the BoardModel object 

*/ 

5 public void updateGreenLed(int i) 

theDeviceModel.updatedGreenLed(i); 

public void updateRedLed(int i) 
10 { 

theDeviceModel.updatedRedLed(i); 
public void updateMode(int i) 
1 5 theDeviceModel.updatedMode(i); 
public void updateButton(int i) 

theDeviceModel.updatedButton(i); 

20 } 
} 

} 

The foregoing files may be used with the HTTP Tunneling example that demonstrates 
25 how to use a Java applet to communicate with a Java servlet, which in turn will communicate 
with the device on the emGateway™ software of EMIT 4.0. The applet AppToServlet 
communicates with the servlet EmitServlet4 via HTTP tunneling over Port 80, and the servlet 
acts as a communication link between the applet and the device on the emGateway™ software. 
When EmitServlet4.java is compiled, five class files should be generated: 
30 EmitServlet4.class, BoardModel.class, DeviceSetter.class, DeviceUpdate&class and 
EmitHandler.class. The preceding five class files should then be manually copied into the 
servlet directory of the same web server from which the applet will be served. For example, if 
the Apache Web Server is being used along with Caucho's Resin Java Servlet Engine, and if the 
Apache Web Server was installed into its default location on a Windows 32-bit platform, then 
35 the above mentioned class files should be copied to the following directory: 

C:\Program FilesVApache Group\Apache\htdocs\web-inf\classes\ 
The file emWarejar (available from em Ware) should be copied from the default EMIT® 4.0 
installation directory 

C:\emWareWisualCafeExtras\bin\Components\ 
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into the lib directory of the Java Servlet Engine. For example, if you are using version 1 ,2.bl of 
Caucho's Resin Java Servlet Engine, and if Resin was installed into its default location on a 
Windows 32-bit platform, then the above mentioned jar file should be copied to the following 
directory: 

5 C:\resinL2.bl\lib\ 

When AppToServletjava is compiled, seven class files should be generated: 
ButtonListener.class, DeviceSettings.class, GreenLedListener.class, ModeListener.class, 
RedLedListener.class, ServletMonitor.class and AppToServlet.class. It is recommended that the 
preceding seven class files be compressed within a jar file ~ along with the following sixteen 

10 emObject™ class files (available from em Ware), which can be found within the EMIT® 4.0 
directories, located under the emJava20 default installation directory: AlphaFilter.class, 
BrightnessFilter.class, emBarDisplay.class, EmbeddedVariableEvent.class, 

EmbeddedVariableListener.class, emBevelPanel.class, emKnob.class, emLabelObjectclass, 
emLEDSwitch.class, emSwitch.class, emTransparentObject.class, emTransparentPanel.class, 

15 emType.class, emVariable.class, emVariableLabel.class and ImageUtil.class. With all of the 
preceding twenty three class files included, the jar file should be rendered 55.4 KB in file size. 
The AppToServlet.class is served from the same web server on which EmitServlet4.class will 
run. 

The HTTP tunneling example, from the applet's perspective, occurs as follows: (1) the 
20 AppToServletxlass is called by the browser or applet viewer, along with a parameter 
[servleturl], which is the URL to the EmitServlet4; (2) the method init() is automatically called 
by the browser or applet viewer to inform the applet that it has been loaded into the system; (3) 
the method init0 initializes the applet by instantiating the DeviceSettings object, which 
represents the device status values, and then by instantiating the ServletMonitor object, which 
25 creates a thread that provides communication to the servlet; (4) when the ServletMonitor thread 
is started, its member function run() is called, the servlet URL is retrieved using getParameter(), 
and as long as the applet continues to run, the thread continues to initiate communication with 
the servlet; (5) a URL object is instantiated with the servlet URL, along with a query string in 
which is encoded the values of the device variables as they are to be set from the applet (this is 
30 how the values are communicated to the servlet); (6) then a URLConnectipn object is 
instantiated using the URL object, and the method openConnection() is then called on the 
URLConnection object, which actually initiates a connection to the servlet; (7) now that the 
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connection has been made, a BufferedReader object is instantiated using the getlnputStreamO 
method of the URLConnection object; (8) a String object is then assigned the value returned by 
the readLine() method of the BufferedReader object (after which the BufferedReader stream is 
closed, the servlet has printed to the BufferedReader stream a string of characters used to 
5 transmit the values on the device, this is how the values are communicated back to the applet); 
(9) then the function serverStringParser() is called using the String object just assigned, which 
then parses the data received from the BufferedReader object in order to use this data to obtain 
the new values of the devices settings; (10) now, whenever any values are changed in the applet, 
those changes are recorded in the ServletMonitor object so that the next time the thread initiates 

10 a connection to the servlet those changes get recorded by the servlet (which will in turn 
communicate those changes to the emGateway). 

The HTTP tunneling example, from the servlet' s perspective, occurs as follows: (1) 
EmitServlet4.class is called by an applet call to the server along with a query string in which is 
encoded the values of the device variables as they were set in the applet; (2) the method init() is 

15 automatically called by the servlet container to indicate that the servlet is being placed into 
service; (3) the method init() initializes the servlet by instantiating the BoardModel object, 
which provides a model for the values on the physical device; (4) then the DeviceSetter object is 
instantiated, which provides a mechanism to set values on the physical device (the BoardModel 
object is required in order to instantiate the DeviceSetter object); (5) then the DeviceUpdated 

20 object is instantiated, which makes changes to the BoardModel object when the physical device 
changes (the DeviceSetter object is required in order to instantiate the DeviceUpdated object); 
(6) then the EmitHandler object is instantiated, which creates a separate thread that establishes a 
connection to the emGateway™ software, acting as a communication link between the applet 
and the emGateway™ software (DeviceUpdated object and the BoardModel object are both 

25 required in order to instantiate the EmitHandler object); (7) when the EmitHandler thread is 
started, its member function run() is automatically called; (8) the JEmit object is then 
instantiated; (9) the host field of the JEmit object is set with the IP address or name of the 
emGateway™ host computer; (10) the port field of the JEmit object is set with the emGateway™ 
HTTP port number; (1 1) the device name of the JEmit object is set with the device string; (12) 

30 the username field is set with the username that the Jemit object is using to connect to the 
emGateway™ computer; (13) the password field is set with the password (associated with 
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username) on the emGateway™ computer; (14) then the JEmit object is connected to the 
emGateway™ computer; (15) the servlet is then added to the JEmit object as an 
EmbeddedListener, and the embedded device variables are subscribed to in the JEmit object; 
(16) now when one of the subscribed device variables is changed on the physical device, the 
5 EmitHandler member function embeddedVariableChanged() is called; (17) the function 
embeddedVariableChanged() determines what embedded event was fired, and then calls the 
appropriate update function from the DeviceUpdated object for the given event; (18) the given 
DeviceUpdated update function then calls the appropriate update function from the BoardModel 
object, which in turn sets the value of the given member variable of the BoardModel object - 

10 thus providing a representation of the values on the physical device. When the servlet needs to 
obtain access to the physical values on the device the values can be accessed from the 
BoardModel object ( the reason for the round-about way of updating values in steps (9) and (10) 
is to modularize the process so that the variables and methods of the DeviceUpdated object and 
the BoardModel object may be accessed from varied instances); (19) each time the servlet is 

15 called, the doGet() method is initiated by the server (via the service method) in order to allow 
the servlet to handle a GET request, the doGet() method then parses the device values from the 
query string with the getParameter() method, and these values are then used to update 
theDeviceModel object (this is how the values are communicated from the applet); (20) finally, 
the doGet() method prints output to the servlet response, which provides a stream of characters 

20 back to the applet, the character stream is constructed using the values provided by the 
BoardModel object, thus communicating any changes made to the physical device (this is how 
the values are communicated back to the applet). 

The HTTP Tunneling example may be used with the Apache Web Server along with 
Caucho's Resin Java Servlet Engine, on a Windows 32-bit platform. In current design, to install 

25 the Apache Web Server and the emGateway™ software on the same machine, they are 
configured for differ port numbers, as they currently cannot both share the same port. The 
HTTP Tunneling example assumes that the Apache Web Server has been configured on port 80 
and that the emGateway™ software has been configured on port 8 1 . 

After the emGateway™ software, the Apache Web Server and the Resin Servlet Engine 

30 have been started, the example may be run. All Java servlet class files may be placed in the 
following directory: 



